Dev kit

Dev Kit

Structured development workflows — from ideation to production, with adversarial review and root cause analysis at every stage.

Dev Lifecycle

brainstorm → plan → cook (implement) → test → code-review → ship
                         ↕
                    debug ↔ fix

Key Capabilities

• Structured brainstorming with trade-off analysis and exact requirements extraction
• Implementation planning with research phases and solution design
• Feature implementation pipeline (scout → plan → code → test → review → finalize)
• Systematic debugging with 10 technique references (root cause, logs, CI, perf, frontend)
• Bug fixing with complexity routing, prevention gates, and no-side-effect verification
• Test execution (unit/integration/e2e/UI) with coverage and QA reports
• Adversarial 3-stage code review (spec compliance → quality → red-team)
• Fast codebase scouting with parallel agents

Routing — Intent to Skill

When the user says something, route to the correct skill:

User Intent	Skill	Reference
Brainstorm ideas, evaluate approaches	brainstorm	references/brainstorm/SKILL.md
Plan implementation, design architecture	plan	references/plan/SKILL.md
Implement feature, execute plan	cook	references/cook/SKILL.md
Fix bug, resolve error	fix	references/fix/SKILL.md
Debug issue, investigate root cause	debug	references/debug/SKILL.md
Run tests, check coverage	test	references/test/SKILL.md
Review code, audit PR	code-review	references/code-review/SKILL.md
Find files, explore codebase	scout	references/scout/SKILL.md

Priority when ambiguous:

• Prefer fix if user mentions a concrete error or failing test
• Prefer debug if user mentions investigation, root cause, or "why"
• Prefer cook if user mentions implementing or building something new
• Prefer brainstorm if user says "should we", "what if", or "how about"
• Prefer plan if user mentions architecture, roadmap, or phases

Defaults

• Language: Vietnamese for explanations, English for code
• Principles: YAGNI, KISS, DRY — always
• Scout first: always scan codebase before asking questions or forming hypotheses
• No guessing: evidence-based decisions only
• Verify before claiming: fresh test output required before any "done" claim

Behavior Rules

Scout-First (Mandatory)

Every skill MUST scan the codebase before:

• Asking clarifying questions
• Forming hypotheses
• Proposing approaches
• Writing code

No Side Effects

Implementation and fixes are NOT done until verified side-effect-free:

1. All tests pass (modified + transitively-affected modules)
2. No business logic regression in blast radius
3. No new lint/type/build errors
4. Public contracts unchanged unless intentional

Adversarial Review (Always-On)

Every code change gets 3-stage review:

1. Spec compliance — does it match what was requested?
2. Code quality — standards, security, performance
3. Red-team — actively tries to break the code

Verification Iron Law

NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE. Run command → Read output → Confirm pass → Then claim result.

Skill Details

brainstorm

Structured ideation with scout-first, exact requirements gates, and trade-off analysis. Ends with design doc + handoff to /plan.

plan

Implementation planning with research phase, codebase understanding, solution design, and phase-by-phase output. Creates actionable plans for /cook.

cook

End-to-end feature implementation. Modes: --interactive (default), --fast, --auto, --parallel, --no-test, --tdd. Full pipeline: scout → research → plan → implement → test → review → finalize.

fix

Bug fixing with intelligent routing. Modes: --auto (default), --review, --quick, --parallel. Pipeline: scout → diagnose → assess complexity → fix → verify+prevent → finalize.

debug

Systematic debugging framework. Techniques: systematic debugging, root cause tracing, defense-in-depth, verification, investigation methodology, log/CI analysis, performance diagnostics, frontend verification.

test

Comprehensive testing. Supports: unit/integration/e2e (Jest/Vitest/pytest/Go/Rust/Flutter), UI testing via browser automation, coverage analysis, structured QA reports.

code-review

Adversarial review with input modes: #PR, commit hash, --pending, codebase, codebase parallel. Three-stage protocol + task-managed review pipelines for multi-file features.

scout

Fast codebase scouting using parallel agents. Supports internal (Explore subagents) and external (Gemini/OpenCode) modes. Divides codebase into segments for maximum coverage.

Language-Specific Rules

Load the appropriate reference when working with a specific language/framework:

Language	Reference	When to Load
Java (core)	references/languages/java/core-rules.md	Any Java code — bans, musts, style, error handling
Java (Spring Boot)	references/languages/java/spring-boot.md	Spring controllers, services, repos, config, exceptions
Java (Clean Arch)	references/languages/java/clean-architecture.md	Layer structure, dependency rules, anti-patterns
Java (Testing)	references/languages/java/testing.md	JUnit 5, Testcontainers, Mockito, JPA testing
TypeScript (core)	references/languages/typescript/core-rules.md	Any TS/frontend code — bans, type safety, a11y, security
TypeScript (React/Next.js)	references/languages/typescript/react-nextjs.md	React components, Zustand, TanStack Query, App Router
TypeScript (Vue/Nuxt)	references/languages/typescript/vue-nuxt.md	Vue 3 Composition API, Pinia, Nuxt patterns
TypeScript (API)	references/languages/typescript/api-patterns.md	Fetch wrapper, BFF, response validation, optimistic updates
TypeScript (Forms)	references/languages/typescript/forms.md	React Hook Form, VeeValidate, Zod schemas, Server Actions

Shared References

• references/_shared/workflow-artifacts.md — Review artifact schema and validator contract

Tech Stack Support

Language/framework agnostic. Works with any:

• Languages: TypeScript, JavaScript, Python, Go, Rust, Java, Flutter/Dart
• Frameworks: React, Next.js, Express, FastAPI, Django, Spring, etc.
• Test runners: Jest, Vitest, Mocha, pytest, go test, cargo test, flutter test
• CI/CD: GitHub Actions, GitLab CI, any pipeline
• Tools: gh CLI, git, npm/pnpm/yarn, pip, cargo, go