# Docs Workflow Bootstrap

> Explicitly scaffold or adapt an optional repository-local Markdown convention for requirement and completion indexes, shared Milestones, Feature-owned specifications and designs, and nested child Task contracts. Use only when a team asks Waypoint to initialize human-readable engineering documentation without requiring local tracking or a fixed workflow.

- Skill: `adol1111/docs-workflow-bootstrap` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add adol1111/docs-workflow-bootstrap`
- Raw SKILL.md: https://api.skillmd.com/api/skills/adol1111/docs-workflow-bootstrap/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing, Productivity
- Author: adol1111 (https://skillmd.com/u/adol1111)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/adol1111/docs-workflow-bootstrap

---


# Docs Workflow Bootstrap

Create only the durable documentation convention the repository will actually use.

## Inspect and confirm

1. Read repository instructions and existing documentation, ADR, issue, roadmap, Feature, and tracker conventions.
2. Reuse existing locations. Do not create a parallel `docs/` tree beside a working convention.
3. Determine whether the user wants Milestone-grouped Features or standalone flat Features. Show the exact roots and files that would be created or adapted, then ask the user to confirm before scaffolding. Never introduce Milestones merely to choose a directory layout.
4. Create no placeholder Milestones, Features, Tasks, specs, designs, plans, or tracker records.

Use [references/feature-convention.md](references/feature-convention.md) only when no stronger local form exists. The same Feature layout works with an external tracker, the optional `local-work-tracker`, or no operational tracker. This setup skill does not choose or initialize a tracker.

Offer `docs/context/` for glossary and durable context and `docs/architecture/decisions/` for qualifying ADRs only when useful. A user may request either location without accepting the delivery layout.

Do not create substantive requirements, Milestone scope, Feature ownership, specifications, technical designs, Task graphs, implementation plans, identity configuration, branch policy, labels, or code. Finish after reporting created, reused, and deliberately omitted locations.

