Agent skill
workflow-methodology
Core development methodology for claude-flow. Enforces TDD (test-first), systematic debugging (4-phase), and verification gates. Use when starting any development task, fixing bugs, or completing features.
Install this agent skill to your Project
npx add-skill https://github.com/Dutchthenomad/claude-flow/tree/main/skills/workflow-methodology
SKILL.md
Claude-Flow Development Methodology
The 5 Iron Laws
1. TDD Iron Law
"NO production code without a failing test first"
RED → GREEN → REFACTOR
- Write ONE failing test
- Implement MINIMAL code to pass
- Refactor while tests pass
- Commit at each green
2. Verification Law
"Evidence before claims, always"
Before claiming ANY task complete:
- Run fresh tests (not cached)
- Read complete output
- Confirm exit code 0
- Verify original symptom fixed
3. Debugging Law
"Root cause before fix attempts"
4-Phase Protocol:
- Investigate - Reproduce, read errors, check recent changes
- Analyze - Find working examples, compare patterns
- Hypothesize - Test ONE change at a time, max 3 attempts
- Implement - TDD the fix after understanding
4. Planning Law
"Plans executable with zero context"
Plans must include:
- Exact file paths
- Complete code examples
- Verification commands
- No assumptions about reader knowledge
5. Isolation Law
"Isolated workspace for each feature"
Use git worktrees:
git worktree add .worktrees/feature-name -b feature/feature-name
Red Flags (STOP immediately)
- Writing code before tests
- Tests passing immediately
- Multiple simultaneous changes
- "Just this once" thinking
- Using "should," "probably," "seems to"
- Third fix attempt failed
Thinking Budget
| Keyword | Tokens | Use For |
|---|---|---|
think |
~4k | Simple tasks |
think hard |
~10k | Debugging |
think harder |
~20k | Complex changes |
ultrathink |
~32k | Architecture |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
setup-pre-commit
Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.
git-guardrails-claude-code
Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.
scaffold-exercises
Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.
obsidian-vault
Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
handoff
Compact the current conversation into a handoff document for another agent to pick up.
migrate-to-shoehorn
Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.
Didn't find tool you were looking for?