Stackflow

Core Principle

• Gstack-style judgment: decide what matters, challenge weak scope, review adversarially, and ship with practical confidence.
• Superpowers-style execution: write plans, use TDD, debug systematically, verify before completion, and preserve clean handoffs.

1. Decision — validate the idea, clarify PMF, challenge scope, and record major decisions.
2. Planning — turn approved scope into a technical plan, context map, and atomic tasks.
3. Execution — implement with TDD, focused tasks, code review, debugging discipline, QA, and release handoff.

Command Aliases

commands/

/sf-think

commands/sf-think.md

/sf-challenge

commands/sf-challenge.md

/sf-plan

commands/sf-plan.md

/sf-autoplan

commands/sf-autoplan.md

/sf-build

commands/sf-build.md

/sf-debug

commands/sf-debug.md

/sf-review

commands/sf-review.md

/sf-qa

commands/sf-qa.md

/sf-ship

commands/sf-ship.md

How to Use

stackflow

/sf-think I want to build a real-time multiplayer cursor tracker.

/sf-plan Read design-doc.md, consider existing ADRs, create a context map, and write task.md.

/sf-build Implement task.md using strict RED-GREEN-REFACTOR TDD.

Artifacts

• design-doc.md

  — validated product and solution blueprint

• .stackflow/decisions/NNNN-short-name.md

  — ADR-style long-term decisions

• .stackflow-context.md

  — concise repository context map, preferably signatures and structure rather than full file bodies

• task.md

  — atomic implementation tasks
• QA/review/debug reports as Markdown when useful

Safety and Constraints

• Do not write production code during decision or planning commands unless the user explicitly switches to execution.
• Do not invent requirements, benchmarks, security claims, or test results.
• Prefer small, verifiable steps over broad rewrites.
• For implementation, write or update tests before production code whenever feasible.
• Do not commit, push, merge, or open PRs unless the user explicitly asks.
• Use Goose-available tools and normal repository files. Do not assume external runtime-specific commands or paths.

References

• references/gstack/

• references/superpowers/