DocFlow

August 12, 2026 · View on GitHub

Last updated: 2026-08-13 Rules: NAMING.md

Open First

#	Document	Scope
0	Overview	Product identity, users, modules, and value

Document	Description
Plugin workflow	Doctor/adopt/repair/init flow, script backend, hook behavior, and agent surfaces
Document validation	Validation gate, metadata/update-log checks, blocker severity, and command wrappers
Adoption-aware validation	Strict/adopted profiles, code-aware placeholders, helper upgrades, and bounded context

Document	Description
Commands	Local script, Claude command, and Codex skill command reference
Glossary	Shared terminology for docs, scripts, and agent UX
Context efficiency	Loading contract, reproducible measurements, limits, and interpretation rules

Need	Command
Check if DocFlow is ready	`/docflow:check`
Inspect repo docs	`/docflow:doctor`
Initialize empty docs	`/docflow:init`
Adopt existing docs	`/docflow:adopt`
Repair generated map/helpers	`/docflow:repair`
Validate docs before completion	`/docflow:validate`
Create a feature plan	`/docflow:feature-plan <msg>`
Draft product WHAT docs	`/docflow:product-spec <msg or code path>`

#	Title	Status
0001	Plain Markdown and Bash as the portable core	Accepted

Roadmap — critical / now / next / later
Hygiene: Marketplace readiness — HOL scanner workflow and CI hardening for plugin listing
Features: Clear command docs portal — README command clarity and clean browser portal
Features: Document validation and update logs — validation gate for metadata, update logs, links, maps, and blockers
Features: Friendly readiness check — one-screen status and next command for usability
Features: Message-driven feature plan — /docflow:feature-plan <msg> status + feature log
Features: Message-driven product spec — /docflow:product-spec <msg or code path> status + feature log
Features: Adoption-aware validation — real-repository compatibility and upgrade-safe repair