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)

  1. Pass paths only, not content: agents/sub-agents only pass ..._path, let the executor read the file itself.
  2. Files are first-class citizens: Every step must persist artifacts; failures can be retried; replayable; traceable.
  3. 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.
  4. 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.
  5. Hooks doctor (required check; non-blocking): If running under Claude Code and you want the evolution loop active, run tool-hooks-doctor once early; if hooks are missing, offer to install project-level hooks (continue either way).

0) Brainstorm Module (Replaces Old Approach)

Related skills

More from heyvhuang/ship-faster

Installs
47
GitHub Stars
338
First Seen
Feb 10, 2026