How focus695/bocode works
BoCode is a project template for human-and-agent software development: code is the executable truth, while the book is the navigable knowledge base. The principal cycle is to consult plans, guidelines, experience, and issues; pass through gated requirements, analysis, design approval, implementation, testing, review, and wrap-up; then write summaries, lessons, issues, changelogs, and an updated index back to the book. The graph reflects README-documented behavior; sampled source confirms the index generator and commit validator, but does not expose skill internals.
Main entry points: code Implementation · workflow.md Wrap-up · notes Running records · README.md Book index
Components 20
Gated workflow
- Requirements brief
book/guidelines/workflow.md - Analysis
book/guidelines/workflow.md - Design approval
book/guidelines/workflow.md - Implementation
code - Testing
book/guidelines/workflow.md - Review
book/guidelines/workflow.md - Wrap-up
book/guidelines/workflow.md
Project knowledge
- Knowledge base
book - Plans
book/plans - Guidelines
book/guidelines - Running records
book/notes - Book index
book/README.md
Agent skills
- Session discipline
skills/bocode/SKILL.md - Scope gates
skills/boscope/SKILL.md - Book write-back
skills/book-writeback/SKILL.md - Writing discipline
skills/bowrite/SKILL.md
Template tooling
- Index generator
code/tools/gen-book-index.mjs - Commit validator
scripts/check-commit-message.mjs
Other components
- Human
- AI agent
Connections 21
- Human → Requirements brief: sets scope
README.md - AI agent → Requirements brief: fills brief
README.md - Requirements brief → Analysis: gates
README.md - Analysis → Design approval: informs
README.md - Human → Design approval: approves
README.md - Design approval → Implementation: authorizes
README.md - Implementation → Testing: proceeds to
README.md - Testing → Review: proceeds to
README.md - Review → Wrap-up: records findings
README.md - Knowledge base → Implementation: drives
README.md - Plans → Implementation: guides
README.md - Guidelines → Implementation: sets baseline
README.md - Running records → Implementation: provides context
README.md - Wrap-up → Running records: writes back
README.md - Wrap-up → Book index: regenerates
README.md - AI agent → Session discipline: invokes
README.md - AI agent → Scope gates: invokes
README.md - AI agent → Book write-back: invokes
README.md - AI agent → Writing discipline: invokes
README.md - Index generator → Book index: generates
code/tools/gen-book-index.mjs - Commit validator → Human: validates subjects
scripts/check-commit-message.mjs