Docs Workflow Bootstrap
Initialize the minimum docs-driven workflow scaffold for a repository.
This skill is only for repository documentation bootstrap. It does not plan milestones, create implementation tasks, write specs, or authorize code changes.
Composition
- Entry: normally reached from
doc-driven-spec-workflowwhen the repository lacks the minimum docs scaffold. - Owns: minimum docs entry points and compact bootstrap content.
- Does not own: roadmap decomposition, task creation, task-local specs, plans, implementation, or branch closing.
- Handoff: return to
doc-driven-spec-workflowafter reporting created or changed files, unless the user explicitly asks to continue to planning.
Mandatory Rules
- MUST keep bootstrap work in docs governance mode.
- MUST create only the minimum docs entry points unless the user explicitly asks for more.
- MUST NOT create implementation tasks during bootstrap.
- If the user provides actual roadmap or task content during bootstrap, record it only as compact
planning-inbox.mdcandidate context when explicitly requested, then hand off tomilestone-planning. - MUST NOT create
docs/specs/ordocs/plans/by default. - MUST NOT write task-local
spec.mdorplan.md. - MUST report created or changed files and stop.
Bootstrap Layout
Create these files when missing:
docs/index.mddocs/architecture/index.mddocs/tasks/index.mddocs/tasks/planning-inbox.mddocs/context/index.md
Use the repository's documentation language instructions when available. Otherwise follow the user's current language request.
Default Content Shape
Keep generated files compact:
docs/index.md: explain the docs entry point and link to architecture, tasks, and contextdocs/architecture/index.md: explain stable design and behavior boundariesdocs/tasks/index.md: explain roadmap/task tracking; includeOpen Milestones,Completed Milestones, and a link toPlanning Inboxdocs/tasks/planning-inbox.md: explain that unconfirmed goals, opportunities, and roadmap candidates live there until promoted into a milestone, moved to backlog, or discardeddocs/context/index.md: explain research notes and supporting context
Do not create roadmap details during bootstrap unless the user supplies actual roadmap content.
Handoff
After bootstrap:
- Return to
doc-driven-spec-workflowso it can choose the next stage. - Continue directly to
milestone-planningonly when the user explicitly asks to plan milestones, modules, and tasks. - Continue directly to
task-preparationonly when the user explicitly asks, a concrete task is selected from confirmed roadmap state, and dependencies and prior hard gates are clear.
Stop after reporting the bootstrap result unless the user explicitly asks to continue.