site

Author: KSemenenko

.github/workflows/jekyll-gh-pages.yml

@@ -40,13 +40,23 @@ jobs:
           git diff --staged --quiet || git commit -m "Bump version to ${{ steps.version.outputs.VERSION }} [skip ci]"
           git push
 
+      - name: Copy README to github-pages
+        run: |
+          echo '---
+          layout: default
+          title: MCAF Guide
+          nav_order: 1
+          ---
+          ' > github-pages/index.md
+          cat README.md >> github-pages/index.md
+
       - name: Setup Pages
         uses: actions/configure-pages@v5
 
       - name: Build with Jekyll
         uses: actions/jekyll-build-pages@v1
         with:
-          source: ./
+          source: ./github-pages
           destination: ./_site
 
       - name: Upload artifact

_config.yml

@@ -0,0 +1,21 @@
+title: MCAF
+description: Managed Code Coding AI Framework
+remote_theme: just-the-docs/just-the-docs@v0.10.0
+plugins:
+  - jekyll-remote-theme
+  - jekyll-seo-tag
+
+color_scheme: dark
+
+gh_edit_link: true
+gh_edit_link_text: "Edit on GitHub"
+gh_edit_repository: "https://github.com/managedcode/MCAF"
+gh_edit_branch: "main"
+
+nav_enabled: true
+search_enabled: true
+back_to_top: true
+
+exclude:
+  - Gemfile
+  - Gemfile.lock

docs/home.md

@@ -0,0 +1,7 @@
+---
+layout: default
+title: MCAF Guide
+nav_order: 1
+---
+
+<!-- This file is auto-generated from README.md during build -->

github-pages/_config.yml

@@ -0,0 +1,45 @@
+---
+layout: default
+title: Templates
+nav_order: 2
+---
+
+# Templates
+
+Copy these templates to your project and customize them.
+
+---
+
+## AGENTS.md
+
+Agent instructions template for your repository root.
+
+[View on GitHub](https://github.com/managedcode/MCAF/blob/main/docs/templates/AGENTS.md){: .btn .btn-primary }
+[Download](https://raw.githubusercontent.com/managedcode/MCAF/main/docs/templates/AGENTS.md){: .btn }
+
+---
+
+## Feature Template
+
+Feature specification template for `docs/Features/`.
+
+[View on GitHub](https://github.com/managedcode/MCAF/blob/main/docs/templates/Feature-Template.md){: .btn .btn-primary }
+[Download](https://raw.githubusercontent.com/managedcode/MCAF/main/docs/templates/Feature-Template.md){: .btn }
+
+---
+
+## ADR Template
+
+Architecture Decision Record template for `docs/ADR/`.
+
+[View on GitHub](https://github.com/managedcode/MCAF/blob/main/docs/templates/ADR-Template.md){: .btn .btn-primary }
+[Download](https://raw.githubusercontent.com/managedcode/MCAF/main/docs/templates/ADR-Template.md){: .btn }
+
+---
+
+## CLAUDE.md
+
+Simple file that references AGENTS.md for Claude Code.
+
+[View on GitHub](https://github.com/managedcode/MCAF/blob/main/docs/templates/CLAUDE.md){: .btn .btn-primary }
+[Download](https://raw.githubusercontent.com/managedcode/MCAF/main/docs/templates/CLAUDE.md){: .btn }