for-ais-only/DEVELOPER_TASKS.md
This document uses a decision tree format to help developers and AI agents quickly find the right documentation for their task. The format is designed to be both human-readable and machine-parseable.
id: developer-tasks-tree
scope: developer-tasks
rootQuestion: whatAreYouDoing
questions:
whatAreYouDoing:
text: "What are you trying to do?"
whyAsk: "Different tasks require different documentation and understanding of different systems"
answers:
addRenderHook:
value: "Add a new render hook"
nextQuestion: renderHookType
addMetadata:
value: "Add page metadata"
nextQuestion: metadataScope
addCodeExamples:
value: "Add code examples"
outcome:
label: "See: for-ais-only/tcedocs/README.md"
id: tcedocsGuide
understandSystem:
value: "Understand the system"
nextQuestion: whatSystem
renderHookType:
text: "What type of render hook?"
whyAsk: "Different render hooks have different patterns and complexity levels"
answers:
simple:
value: "Simple (like checklist)"
outcome:
label: "Start: for-ais-only/render_hook_docs/AI_RENDER_HOOK_LESSONS.md (Lessons 1-12)"
id: simpleRenderHook
complex:
value: "Complex (like hierarchy/decision-tree)"
outcome:
label: "Start: for-ais-only/render_hook_docs/AI_RENDER_HOOK_LESSONS.md (Lessons 13-20)"
id: complexRenderHook
metadataScope:
text: "What scope of metadata?"
whyAsk: "Metadata can be added at different layers with different implications"
answers:
pageLevel:
value: "Page-level metadata"
outcome:
label: "See: for-ais-only/metadata_docs/PAGE_METADATA_FORMAT.md"
id: pageMetadata
perCodeblock:
value: "Per-codeblock metadata"
outcome:
label: "See: for-ais-only/metadata_docs/IMPLEMENTATION_NOTES.md (Lesson 3)"
id: codeblockMetadata
whatSystem:
text: "What system?"
whyAsk: "Different systems have different architecture and documentation"
answers:
buildSystem:
value: "Build system"
outcome:
label: "See: for-ais-only/BUILD_SYSTEM_ARCHITECTURE.md"
id: buildArch
metadata:
value: "Metadata system"
outcome:
label: "See: for-ais-only/metadata_docs/ARCHITECTURE.md"
id: metadataArch
renderHooks:
value: "Render hooks"
outcome:
label: "See: for-ais-only/render_hook_docs/ARCHITECTURE.md"
id: renderHookArch
codeExamples:
value: "Code examples"
outcome:
label: "See: for-ais-only/tcedocs/SPECIFICATION.md"
id: codeExampleArch
| Task | Primary Doc | Secondary Docs |
|---|---|---|
| Add render hook | render_hook_docs/AI_RENDER_HOOK_LESSONS.md | render_hook_docs/README.md, render_hook_docs/ARCHITECTURE.md |
| Add metadata | metadata_docs/PAGE_METADATA_FORMAT.md | metadata_docs/IMPLEMENTATION_NOTES.md, metadata_docs/ARCHITECTURE.md |
| Add code examples | tcedocs/README.md | tcedocs/SPECIFICATION.md |
| Understand build | BUILD_SYSTEM_ARCHITECTURE.md | Makefile, build/make.py |