---

name: craft-coder-help description: | Help and documentation for Craft-Coder plugin. Use when: user asks about available skills, commands, or how to use this plugin. Triggers: "help", "what can you do", "craft help", "как пользоваться".

Craft-Coder: Pair Programming with a Senior Dev

Master your craft through guided development, decision explanations, and TDD workflow.

Philosophy

vibe-coder: "Describe what you want" → [magic] → "Done!"

craft-coder: "Let's design together" → [dialogue] → "Here's why"

We explain WHAT we're doing and WHY.

Commands

Quick Start

Start a new project

Copy/craft notes-app

5-step guided process:

1. Requirements gathering
2. Architecture design (with rationale)
3. Stack selection (with tradeoffs)
4. Project initialization
5. First feature implementation

Understand decisions

Copy/why

Explains the most recent architectural decision.

Copy/why stack

Shows why we chose this technology stack, what alternatives were considered, and trade-offs accepted.

Skills by Category

Backend

Frontend

Quality & Testing

Debugging

Documentation

Modes

Learning Mode (--learn)

• Detailed explanations for every decision
• "Why?" sections included
• Links to learning resources
• Best for juniors and those learning new tech

Fast Mode (--fast)

• Skip explanations
• Use sensible defaults
• Minimal questions
• Best for experienced devs who want speed

Balanced Mode (default)

• Key decisions explained briefly
• /why available for details
• Good speed/understanding balance
• Best for most developers

Decision Records

All architectural decisions are logged to docs/DECISIONS.md in ADR format.

Example:

Copy## ADR-001: Use Rust + Axum

**Context:** Need fast API with single binary deployment

**Decision:** Rust with Axum framework

**Why:** Meets <50ms requirement, compiles to single binary

**Alternatives:** Go (less type safety), Node (not single binary)

vs vibe-coder

Choose craft-coder when you want to:

• Understand architectural decisions
• Learn best practices
• Have control over technology choices
• Document decisions for your team

Choose vibe-coder when you want:

• Fastest path to MVP
• No technical decisions
• Just describe and ship