# Atelier


> A personal development toolkit for AI agents. It covers spec-driven development, code quality, and deep thinking.

Atelier gives coding agents a disciplined way to move from an idea to reviewed, verified code without taking control away from the developer.

```bash npx @martinffx/atelier@latest init --harness <claude|opencode|codex|cursor> ```

Install the skills separately:

```bash npx skills add martinffx/atelier ```

Update installed skills with:

```bash npx skills update martinffx/atelier ```

For OpenCode, installing skills first also creates slash commands for every installed skill marked `user-invocable: true`. If you initialized OpenCode before installing the skills, run:

```bash npx @martinffx/atelier@latest update --harness opencode ```

## How Atelier works

Atelier uses as much process as each request needs. Bounded work gets a concise plan in the conversation. Substantial work gets a durable spec, an implementation plan, and tracked execution. The developer approves the plan before implementation begins.

```mermaid flowchart TD R[Request] --> O[atelier-orchestrator]

O -->|Bounded work| IP[spec-plan: Inline Plan] IP --> IA{Developer approval} IA -->|Approved| IS[Stop] IA -.->|Revise| IP

IS -->|New implementation request| I[Implement directly] I --> V[Validate] V -.->|Issues found| I IP -.->|Needs brainstorming| B I -.->|Needs brainstorming| B

O -->|Substantial work| B[spec-brainstorm] B --> D[design.md] D --> BS[Stop] BS -->|New planning request| G[oracle-grill-me] G --> P[spec-plan] G -.->|Refine design| D P --> SA{Developer approval} SA -->|Approved| J[plan.json] SA -.->|Revise plan| P SA -.->|Revisit design| B J --> PS[Stop] PS -->|New implementation request| SI[spec-implement] SI --> CR[code-review] CR --> F[spec-finish] F --> PR[code-pull-request] SI -