docs-workflow-bootstrap
Creates the minimum docs-driven workflow scaffold for a repository. Use when the repository is missing core workflow entry-point docs.
How do I install this agent skill?
npx skills add https://github.com/adol1111/doc-driven-spec-workflow --skill docs-workflow-bootstrapIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a utility for bootstrapping a repository's documentation structure. It creates basic markdown entry points like index and task lists. It does not engage in network activity, handle sensitive credentials, or execute arbitrary code.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Docs Workflow Bootstrap
Purpose
Create the minimum workflow scaffold so later stages have authoritative docs to read.
Use when
- one or more minimum scaffold files are missing
- the repository has not been initialized for this docs-driven workflow
- later stages cannot recover state because the basic docs entry points do not exist yet
Do not use when
- the minimum scaffold already exists
- the current work is roadmap decomposition, task-local design, or execution
- the user wants implementation tasks, specs, plans, or code changes during bootstrap
Read first
- existing
docs/files, if any - repository doc language cues, if any
- the current user prompt
Owns
- minimum scaffold detection
- creation of the minimum workflow entry-point docs
- compact planning-inbox goal capture only when explicitly requested during bootstrap
- bootstrap review pause and handoff suggestion
Must not own
- milestone decomposition
- implementation task creation
- task-local
spec.mdorplan.md - implementation or branch workflow
- overfilling scaffold docs with roadmap or execution detail
Entry checks
Create only these files when missing:
docs/index.mddocs/architecture/index.mddocs/tasks/index.mddocs/tasks/planning-inbox.mddocs/tasks/backlog.mddocs/context/index.md
Use repository doc language rules when available. Otherwise follow the current user language.
Default flow
- Detect which minimum scaffold files are missing.
- Create only the missing workflow entry points.
- Keep content minimal and navigational.
- If the user explicitly asks to preserve roadmap-like input during bootstrap, record it only as compact planning-inbox goal context.
- Stop at a bootstrap review pause after reporting created or changed files.
Boundary rules
- Bootstrap is docs governance only.
- Do not create milestones, modules, tasks,
spec.md,plan.md,docs/specs/, ordocs/plans/by default. - Do not turn broad user requirements into task breakdown during bootstrap.
planning-inbox.mdmay capture compact goal context, but it is not milestone decomposition.- Keep scaffold docs small enough that later stages can reshape them without cleanup work.
If blocked
- If the minimum scaffold exists but the next stage is unclear, hand off back to
doc-driven-spec-workflow. - If the user asks for roadmap planning during bootstrap, finish the minimal scaffold first, then suggest
milestone-planning. - If the user asks for concrete task execution during bootstrap, do not skip directly there unless the repository already has confirmed roadmap state.
Review and follow-up
- Stop at a bootstrap review pause after reporting created or changed files.
- Treat clear forward-motion language after that review pause as permission for routine follow-up.
- Default follow-up after review is:
- commit reviewed scaffold docs
- unless the user explicitly asks to leave them uncommitted
- then return to
doc-driven-spec-workflowso routing can choose the next stage
- Continue directly to another stage only when the user explicitly asks for that path.
Output
- created files
- changed files
- preserved planning-inbox goal context, if any
- recommended next skill
Stop point
- bootstrap review pause
Handoff
DecidedUndecidedNext skillStop point
References
- Use
references/scaffold-template.mdfor minimum scaffold document shape.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/adol1111/doc-driven-spec-workflow/docs-workflow-bootstrap">View docs-workflow-bootstrap on skillZs</a>