for-ais-only/REPOSITORY_MAP_FOR_AI_AGENTS.md
"(root)":
_meta:
link: "../"
"README.md":
_meta:
link: "../README.md"
description: "General project info (not AI-focused)"
"AI_AGENT_DEVELOPER_GUIDE.md":
_meta:
link: "../AI_AGENT_DEVELOPER_GUIDE.md"
description: "ā START HERE (AI agents)"
"for-ais-only":
_meta:
link: "./"
description: "AI-FRIENDLY DOCUMENTATION"
"BUILD_SYSTEM_ARCHITECTURE.md":
_meta:
link: "./BUILD_SYSTEM_ARCHITECTURE.md"
description: "[RECOMMENDED] Build pipeline overview"
"DEVELOPER_TASKS.md":
_meta:
link: "./DEVELOPER_TASKS.md"
description: "[RECOMMENDED] Task decision tree"
"REPOSITORY_MAP_FOR_AI_AGENTS.md":
_meta:
link: "./REPOSITORY_MAP_FOR_AI_AGENTS.md"
description: "This file"
"render_hook_docs":
_meta:
link: "./render_hook_docs/"
description: "RENDER HOOKS (interactive components)"
"README.md":
_meta:
link: "./render_hook_docs/README.md"
description: "Overview of 3 render hooks"
"AI_RENDER_HOOK_LESSONS.md":
_meta:
link: "./render_hook_docs/AI_RENDER_HOOK_LESSONS.md"
description: "ā 12+ implementation lessons"
"DECISION_TREE_FORMAT.md":
_meta:
link: "./render_hook_docs/DECISION_TREE_FORMAT.md"
description: "YAML format specification"
"HIERARCHY_FORMAT.md":
_meta:
link: "./render_hook_docs/HIERARCHY_FORMAT.md"
description: "YAML format specification"
"DECISION_TREE_IMPLEMENTATION_NOTES.md":
_meta:
link: "./render_hook_docs/DECISION_TREE_IMPLEMENTATION_NOTES.md"
"metadata_docs":
_meta:
link: "./metadata_docs/"
description: "PAGE METADATA SYSTEM"
"PAGE_METADATA_FORMAT.md":
_meta:
link: "./metadata_docs/PAGE_METADATA_FORMAT.md"
description: "ā Complete metadata structure"
"IMPLEMENTATION_NOTES.md":
_meta:
link: "./metadata_docs/IMPLEMENTATION_NOTES.md"
description: "ā 10 key design lessons"
"tcedocs":
_meta:
link: "./tcedocs/"
description: "CODE EXAMPLES SYSTEM"
"README.md":
_meta:
link: "./tcedocs/README.md"
description: "User guide for code examples"
"SPECIFICATION.md":
_meta:
link: "./tcedocs/SPECIFICATION.md"
description: "1600-line technical spec"
"content":
_meta:
link: "../content/"
description: "DOCUMENTATION PAGES"
"ai-agent-resources.md":
_meta:
link: "../content/ai-agent-resources.md"
description: "AI-friendly resources index"
"develop":
_meta:
link: "../content/develop/"
description: "Development guides"
"integrate":
_meta:
link: "../content/integrate/"
description: "Integration guides"
"operate":
_meta:
link: "../content/operate/"
description: "Operations guides"
"layouts":
_meta:
link: "../layouts/"
description: "HUGO TEMPLATES"
"partials":
_meta:
link: "../layouts/partials/"
description: "Reusable components"
"shortcodes":
_meta:
link: "../layouts/shortcodes/"
description: "Markdown shortcodes"
"_default":
_meta:
link: "../layouts/_default/"
description: "Default page templates"
"_markup":
_meta:
link: "../layouts/_default/_markup/"
description: "Render hooks"
"data":
_meta:
link: "../data/"
description: "DATA FILES"
"components":
_meta:
link: "../data/components/"
description: "Language/client configurations"
"examples.json":
_meta:
link: "../data/examples.json"
description: "Generated code example metadata"
"static":
_meta:
link: "../static/"
description: "STATIC ASSETS"
"js":
_meta:
link: "../static/js/"
description: "JavaScript for interactive components"
"schemas":
_meta:
link: "../static/schemas/"
description: "JSON schemas for validation"
"css":
_meta:
link: "../static/css/"
description: "CSS files"
"config.toml":
_meta:
link: "../config.toml"
description: "ā Hugo configuration"
"Makefile":
_meta:
link: "../Makefile"
description: "Build commands"
"package.json":
_meta:
link: "../package.json"
description: "Node.js dependencies"
"requirements.txt":
_meta:
link: "../requirements.txt"
description: "Python dependencies"
"public":
_meta:
description: "Generated HTML (gitignored)"
"I want to understand the project" ā Start: AI_AGENT_DEVELOPER_GUIDE.md
"I want to add a render hook" ā Start: for-ais-only/render_hook_docs/README.md ā Then: for-ais-only/render_hook_docs/AI_RENDER_HOOK_LESSONS.md ā Reference: layouts/_default/_markup/render-codeblock-*.html
"I want to add page metadata" ā Start: for-ais-only/metadata_docs/PAGE_METADATA_FORMAT.md ā Then: for-ais-only/metadata_docs/IMPLEMENTATION_NOTES.md ā Reference: layouts/partials/toc-json-regex.html
"I want to add code examples" ā Start: for-ais-only/tcedocs/README.md ā Then: for-ais-only/tcedocs/SPECIFICATION.md ā Reference: build/components/example.py
"I want to understand the build system" ā Start: Makefile ā Then: build/make.py ā Reference: for-ais-only/BUILD_SYSTEM_ARCHITECTURE.md [RECOMMENDED]
Progressive Enhancement ā for-ais-only/render_hook_docs/AI_RENDER_HOOK_LESSONS.md (Lesson 1)
Page Store Pattern ā for-ais-only/render_hook_docs/AI_RENDER_HOOK_LESSONS.md (Lesson 2)
Metadata Architecture ā for-ais-only/metadata_docs/IMPLEMENTATION_NOTES.md (Complete Metadata Architecture)
Configuration Centralization ā for-ais-only/metadata_docs/IMPLEMENTATION_NOTES.md (Lesson 6) ā config.toml (clientsConfig section)
Security Best Practices ā for-ais-only/render_hook_docs/AI_RENDER_HOOK_LESSONS.md (Lesson 4)
Legend:
Last Updated: 2026-01-08