workflow-project-intake
Installation
SKILL.md
Project Intake (Brainstorm + Clarify + Route)
Treat Skills as "stateless execution units", externalize all state to the file system.
This skill is positioned as "project entry / requirements clarification":
- When user only has a vague idea: help them clarify requirements (minimum information set) before entering execution chain
- When user provides repo / clear objectives: quickly confirm understanding, then enter the correct workflow/step
This skill is not responsible for actual large-scale implementation (that's the job of execution skills like workflow-ship-faster / workflow-feature-shipper). It's responsible for converging "conversation" into "executable input", then handing off control.
Core Principles (Must Follow)
- Pass paths only, not content: agents/sub-agents only pass
..._path, let the executor read the file itself. - Files are first-class citizens: Every step must persist artifacts; failures can be retried; replayable; traceable.
- Write operations must have checkpoints: Any action with external side effects (delete/modify cloud resources/DB writes/refunds/cancel subscriptions) must write a plan first and wait for explicit user confirmation.
- Ask one question at a time: If information is missing, ask follow-ups, but each message asks only 1 question (prefer multiple choice); break complex topics into multiple rounds.
- Hooks doctor (required check; non-blocking): If running under Claude Code and you want the evolution loop active, run
tool-hooks-doctoronce early; if hooks are missing, offer to install project-level hooks (continue either way).