fellowship-dev/dogfooded-skills

spec-plan

Use when stress-testing a plan, getting grilled on a design, or before writing a PRD.

Voir la source

Mode d’emploi

  1. Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
  2. Consultez le document original pour les outils, identifiants et environnements requis.
  3. Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/fellowship-dev/dogfooded-skills --skill spec-plan

Avant de commencer

  • L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
  • Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Document Skill original

Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.

<!-- Original "grill me" concept by Matt Pocock (https://x.com/maaboroshi) -->

spec-plan

Interview the user relentlessly about every aspect of a plan until reaching shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one by one.

When to Use

  • User wants to stress-test a plan or design
  • User says "grill me" or "poke holes in this"
  • Before running issue-to-prd — spec-plan resolves ambiguity, issue-to-prd structures the output
  • Complex feature with many interacting decisions that need to be resolved sequentially

When NOT to Use

  • Requirements are already clear and documented — go straight to issue-to-prd
  • User just wants a quick opinion, not a deep interview
  • Implementation is already underway

Workflow

1. Read existing context

If the plan originates from a GitHub issue:

bash
gh issue view ISSUE_NUMBER --repo ORG/REPO --json body,title,comments

Read all comments too — treat existing questions and answers as already-resolved branches. Do not re-ask anything already answered.

If no issue, read project context:

bash
cat project-instructions.md  # or equivalent project instructions file
cat README.md

2. Interview — one question at a time

For each branch of the design tree:

  • Ask one question
  • Provide your recommended answer with reasoning
  • Wait for the user's response
  • Incorporate the answer and move to the next branch
Warning: ONE question at a time. This is not issue-to-prd's batched Q1-Qn format. Go deep on each branch before moving to the next.

If a question can be answered by exploring the codebase, explore the codebase instead of asking.

3. Resolve dependencies

When decisions depend on each other, resolve the dependency first:

  • Identify which decision blocks others
  • Ask about the blocker first
  • Then proceed to the dependent decisions

4. Handoff to issue-to-prd (optional)

When all branches are resolved, offer:

text
All branches resolved. Want me to run issue-to-prd to structure this into a PRD?

If yes, the shared understanding from this interview becomes the input; issue-to-prd can skip its clarity assessment and go straight to drafting.

Critical Rules

  • One question at a time — depth over breadth
  • Always provide your recommended answer — don't just ask, propose
  • Never re-ask resolved questions — read issue comments first
  • Explore code before asking — if the codebase has the answer, use it
  • Start from where the conversation left off — respect prior discussion

Tâches connexes

du même dépôt

Autres Skills

Tous les Skills