Skip to content

Commit 803a3e3

Browse files
committed
site update
1 parent f88562d commit 803a3e3

File tree

5 files changed

+145
-14
lines changed

5 files changed

+145
-14
lines changed

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

Lines changed: 34 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,9 @@ jobs:
6868
cat > github-pages/templates.md << 'HEADER'
6969
---
7070
layout: default
71-
title: Templates
71+
title: Templates for AGENTS.md, ADR, and Feature Docs
72+
description: Download ready-to-use templates for MCAF and vibe coding. Includes AGENTS.md template for Claude Code, Codex, Gemini, Cursor, ADR templates, and feature documentation for AI-assisted development.
73+
keywords: MCAF templates, AGENTS.md template, vibe coding templates, AI-assisted development, ADR template, Claude Code, Codex, Gemini, Cursor rules
7274
nav_order: 2
7375
---
7476
@@ -100,19 +102,47 @@ jobs:
100102
101103
- name: Copy TUTORIAL to github-pages
102104
run: |
103-
printf '%s\n' '---' 'layout: default' 'title: Tutorial' 'nav_order: 3' '---' '' > github-pages/tutorial.md
105+
cat > github-pages/tutorial.md << 'EOF'
106+
---
107+
layout: default
108+
title: Tutorial - Implement Vibe Coding with Structure
109+
description: Step-by-step tutorial for implementing MCAF in your project. Learn to set up AGENTS.md, configure Coding AI agents like Claude Code, Codex, Gemini, Cursor, and enable safe vibe coding with automated verification.
110+
keywords: MCAF tutorial, vibe coding tutorial, AI-assisted development, AI-assisted coding, AGENTS.md setup, Claude Code, Codex, Gemini, Cursor, GitHub Copilot
111+
nav_order: 3
112+
---
113+
EOF
114+
sed -i 's/^ //' github-pages/tutorial.md
104115
cat TUTORIAL.md >> github-pages/tutorial.md
105116
106117
- name: Copy CREDITS to github-pages
107118
run: |
108-
printf '%s\n' '---' 'layout: default' 'title: Credits' 'nav_order: 4' '---' '' > github-pages/credits.md
119+
cat > github-pages/credits.md << 'EOF'
120+
---
121+
layout: default
122+
title: Credits and Acknowledgments
123+
description: Credits and acknowledgments for MCAF framework contributors. Learn about the team and inspirations behind the Managed Code Coding AI Framework.
124+
keywords: MCAF credits, ManagedCode team, AI framework contributors, acknowledgments
125+
nav_order: 4
126+
---
127+
EOF
128+
sed -i 's/^ //' github-pages/credits.md
109129
cat CREDITS.md >> github-pages/credits.md
110130
111131
- name: Copy README to github-pages with TOC
112132
run: |
113133
WORDS=$(wc -w < README.md)
114134
MINUTES=$(( (WORDS + 200) / 200 ))
115-
printf '%s\n' '---' 'layout: default' 'title: MCAF Guide' 'nav_order: 1' '---' '' > github-pages/index.md
135+
cat > github-pages/index.md << 'EOF'
136+
---
137+
layout: default
138+
title: MCAF - Coding AI Framework for Building Real Software
139+
description: MCAF is a framework that solves the problem of unpredictable AI coding. Build real production software with Coding AI agents using structured context, automated tests as verification gates, and AGENTS.md instructions. Vibe coding that actually works.
140+
keywords: MCAF, Coding AI Framework, AGENTS.md, vibe coding, AI-assisted development, AI-assisted coding, real software, production code, Claude Code, Codex, Gemini, ChatGPT, Cursor, GitHub Copilot, Windsurf, Cline, Aider, ManagedCode
141+
is_home: true
142+
nav_order: 1
143+
---
144+
EOF
145+
sed -i 's/^ //' github-pages/index.md
116146
awk '/^---$/{exit} {print}' README.md >> github-pages/index.md
117147
echo "" >> github-pages/index.md
118148
echo "<p class=\"reading-time\">${MINUTES} min read</p>" >> github-pages/index.md

github-pages/404.html

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,16 @@
11
---
22
layout: default
3-
title: "404"
3+
title: "404: No AGENTS.md Here"
4+
description: This page doesn't exist. But with MCAF and proper AGENTS.md, your code will. Learn how to build real software with AI coding agents.
45
permalink: /404.html
56
---
67

78
<div class="error-page">
89
<h1>404</h1>
9-
<p class="error-subtitle">Page not found</p>
10-
<p class="error-joke">Looks like our AI agent couldn't find this page either.<br>Maybe it's still learning...</p>
10+
<p class="error-subtitle">Vibe coding without MCAF again?</p>
11+
<p class="error-joke">Yeah, we get it. This page doesn't exist.<br>Maybe it's time to read the guide or check out ManagedCode.</p>
1112
<div class="error-actions">
12-
<a href="{{ '/' | relative_url }}" class="btn btn-primary">Back to Guide</a>
13-
<a href="https://www.managed-code.com/" target="_blank" rel="noopener" class="btn">Visit Managed Code</a>
13+
<a href="{{ '/' | relative_url }}" class="btn btn-primary">Read MCAF Guide</a>
14+
<a href="https://www.managed-code.com/" target="_blank" rel="noopener" class="btn">Visit ManagedCode</a>
1415
</div>
1516
</div>

github-pages/_config.yml

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,18 @@
1-
title: MCAF
2-
description: Managed Code Coding AI Framework
1+
title: MCAF - Coding AI Framework
2+
tagline: Build Real Software with Coding AI Agents
3+
description: MCAF (Managed Code Coding AI Framework) is a framework for building real production software with AI coding agents. Not prototypes - real products. It solves the problem of unpredictable AI output through structured context, automated verification via tests, and clear instructions in AGENTS.md.
34
url: "https://mcaf.managed-code.com"
45
baseurl: ""
56

7+
# SEO & AEO (AI Engine Optimization)
8+
keywords: "MCAF, Coding AI Framework, AGENTS.md, vibe coding, AI-assisted development, AI-assisted coding, real software, production code, Claude Code, Codex, Gemini, ChatGPT, Cursor, GitHub Copilot, Windsurf, Cline, Aider, ManagedCode"
9+
author: ManagedCode
10+
11+
# Structured Data for LLMs
12+
organization: ManagedCode
13+
github_repo: managedcode/MCAF
14+
license: CC BY 4.0
15+
616
markdown: kramdown
717
kramdown:
818
auto_ids: true

github-pages/_layouts/default.html

Lines changed: 89 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,15 @@
55
<meta name="viewport" content="width=device-width, initial-scale=1.0">
66

77
<!-- Primary Meta Tags -->
8+
{% if page.is_home %}
9+
<title>{{ site.title }} - {{ site.tagline }}</title>
10+
<meta name="title" content="{{ site.title }} - {{ site.tagline }}">
11+
{% else %}
812
<title>{{ page.title }} | {{ site.title }}</title>
913
<meta name="title" content="{{ page.title }} | {{ site.title }}">
14+
{% endif %}
1015
<meta name="description" content="{{ page.description | default: site.description }}">
11-
<meta name="keywords" content="MCAF, AI, coding agents, framework, software development, AI-assisted development, AGENTS.md, ManagedCode">
16+
<meta name="keywords" content="{{ page.keywords | default: site.keywords }}">
1217
<meta name="author" content="ManagedCode">
1318
<meta name="robots" content="index, follow">
1419

@@ -18,7 +23,11 @@
1823
<!-- Open Graph / Facebook -->
1924
<meta property="og:type" content="website">
2025
<meta property="og:url" content="{{ site.url }}{{ page.url }}">
26+
{% if page.is_home %}
27+
<meta property="og:title" content="{{ site.title }} - {{ site.tagline }}">
28+
{% else %}
2129
<meta property="og:title" content="{{ page.title }} | {{ site.title }}">
30+
{% endif %}
2231
<meta property="og:description" content="{{ page.description | default: site.description }}">
2332
<meta property="og:image" content="{{ '/assets/images/og-image.png' | absolute_url }}">
2433
<meta property="og:image:width" content="1200">
@@ -29,7 +38,11 @@
2938
<!-- Twitter -->
3039
<meta name="twitter:card" content="summary_large_image">
3140
<meta name="twitter:url" content="{{ site.url }}{{ page.url }}">
41+
{% if page.is_home %}
42+
<meta name="twitter:title" content="{{ site.title }} - {{ site.tagline }}">
43+
{% else %}
3244
<meta name="twitter:title" content="{{ page.title }} | {{ site.title }}">
45+
{% endif %}
3346
<meta name="twitter:description" content="{{ page.description | default: site.description }}">
3447
<meta name="twitter:image" content="{{ '/assets/images/og-image.png' | absolute_url }}">
3548

@@ -73,21 +86,95 @@
7386
});
7487
</script>
7588

76-
<!-- Structured Data -->
89+
<!-- Structured Data for SEO & AI/LLM Discovery -->
7790
<script type="application/ld+json">
7891
{
7992
"@context": "https://schema.org",
8093
"@type": "WebSite",
8194
"name": "{{ site.title }}",
95+
"alternateName": ["MCAF", "Managed Code Coding AI Framework"],
8296
"description": "{{ site.description }}",
8397
"url": "{{ site.url }}",
8498
"publisher": {
8599
"@type": "Organization",
86100
"name": "ManagedCode",
87101
"url": "https://managed-code.com"
102+
},
103+
"potentialAction": {
104+
"@type": "SearchAction",
105+
"target": "{{ site.url }}/?q={search_term_string}",
106+
"query-input": "required name=search_term_string"
88107
}
89108
}
90109
</script>
110+
<script type="application/ld+json">
111+
{
112+
"@context": "https://schema.org",
113+
"@type": "SoftwareSourceCode",
114+
"name": "MCAF - Managed Code Coding AI Framework",
115+
"description": "Framework for building real production software with AI coding agents. Solves the problem of unpredictable AI output through structured context, automated tests as verification gates, and AGENTS.md instructions. Works with Claude Code, Codex, Gemini, ChatGPT, Cursor, GitHub Copilot.",
116+
"codeRepository": "https://github.com/managedcode/MCAF",
117+
"programmingLanguage": "Markdown",
118+
"runtimePlatform": "AI Coding Agents",
119+
"license": "https://creativecommons.org/licenses/by/4.0/",
120+
"author": {
121+
"@type": "Organization",
122+
"name": "ManagedCode",
123+
"url": "https://managed-code.com"
124+
},
125+
"keywords": ["MCAF", "Coding AI Framework", "AGENTS.md", "vibe coding", "AI-assisted development", "real software", "production code", "Claude Code", "Codex", "Gemini", "ChatGPT", "Cursor", "GitHub Copilot", "Windsurf", "Cline", "Aider"]
126+
}
127+
</script>
128+
{% if page.is_home %}
129+
<script type="application/ld+json">
130+
{
131+
"@context": "https://schema.org",
132+
"@type": "FAQPage",
133+
"mainEntity": [
134+
{
135+
"@type": "Question",
136+
"name": "What is MCAF?",
137+
"acceptedAnswer": {
138+
"@type": "Answer",
139+
"text": "MCAF (Managed Code Coding AI Framework) is a framework for building real production software with AI coding agents. Not prototypes - real products. It solves the problem of unpredictable AI output by defining structured context, using automated tests as verification gates, and encoding repository-specific rules in AGENTS.md."
140+
}
141+
},
142+
{
143+
"@type": "Question",
144+
"name": "What problem does MCAF solve?",
145+
"acceptedAnswer": {
146+
"@type": "Answer",
147+
"text": "MCAF solves the problem of unpredictable and unreliable AI-generated code. Without structure, AI coding agents produce inconsistent results. MCAF provides three pillars: Context (all information in the repository), Verification (tests and static analysis as hard gates), and Instructions (AGENTS.md defines how AI agents work). This makes AI coding predictable, safe, and repeatable."
148+
}
149+
},
150+
{
151+
"@type": "Question",
152+
"name": "What is AGENTS.md?",
153+
"acceptedAnswer": {
154+
"@type": "Answer",
155+
"text": "AGENTS.md is a file at the repository root that defines how AI coding agents work in a specific codebase. It contains commands for build, test, format, and analyze, coding rules, testing discipline, and maintainer preferences. AI agents read AGENTS.md before making changes to ensure consistent behavior."
156+
}
157+
},
158+
{
159+
"@type": "Question",
160+
"name": "How does MCAF enable safe vibe coding?",
161+
"acceptedAnswer": {
162+
"@type": "Answer",
163+
"text": "MCAF makes vibe coding production-ready. While vibe coding means trusting AI and following the vibes, MCAF adds guardrails: automated tests verify behavior, static analysis catches issues, and AGENTS.md provides consistent instructions. You get the speed of vibe coding with the reliability needed for real software."
164+
}
165+
},
166+
{
167+
"@type": "Question",
168+
"name": "Which AI coding agents work with MCAF?",
169+
"acceptedAnswer": {
170+
"@type": "Answer",
171+
"text": "MCAF works with any AI coding agent that can read repository files. Popular tools include Claude Code, Codex, Gemini, ChatGPT, Cursor, GitHub Copilot, Windsurf, Cline, Aider, and other LLM-based coding assistants. The framework is tool-agnostic - it defines how to work with AI, not which AI to use."
172+
}
173+
}
174+
]
175+
}
176+
</script>
177+
{% endif %}
91178
</head>
92179
<body>
93180
<nav class="nav">

github-pages/index.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,9 @@
11
---
22
layout: default
3-
title: MCAF Guide
3+
title: MCAF - Coding AI Framework for Building Real Software
4+
description: MCAF is a framework that solves the problem of unpredictable AI coding. Build real production software with Coding AI agents using structured context, automated tests as verification gates, and AGENTS.md instructions. Vibe coding that actually works.
5+
keywords: MCAF, Coding AI Framework, AGENTS.md, vibe coding, AI-assisted development, AI-assisted coding, real software, production code, Claude Code, Codex, Gemini, ChatGPT, Cursor, GitHub Copilot, Windsurf, Cline, Aider, ManagedCode
6+
is_home: true
47
nav_order: 1
58
---
69

0 commit comments

Comments
 (0)