@martinffx/atelier 1.2.2 → 1.4.0

package/.codex-plugin/plugin.json

@@ -0,0 +1,27 @@
+{
+  "name": "atelier",
+  "version": "1.2.2",
+  "description": "Personal development toolkit - spec-driven development, code quality, deep thinking, and ecosystem patterns",
+  "author": {
+    "name": "Martin Richards"
+  },
+  "homepage": "https://github.com/martinffx/atelier",
+  "repository": "https://github.com/martinffx/atelier",
+  "license": "MIT",
+  "keywords": [
+    "spec-driven-development",
+    "code-quality",
+    "deep-thinking",
+    "typescript",
+    "python",
+    "codex"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Atelier",
+    "shortDescription": "Personal development toolkit - spec-driven development, code quality, deep thinking, and ecosystem patterns",
+    "developerName": "Martin Richards",
+    "category": "Developer Tools",
+    "capabilities": ["Read"]
+  }
+}

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## [1.4.0](https://github.com/martinffx/atelier/compare/v1.3.0...v1.4.0) (2026-07-18)
+
+
+### Features
+
+* **code-commit:** improve commit workflow ([a5e8973](https://github.com/martinffx/atelier/commit/a5e89735ec8623ea24effec326010136cb546735))
+* **codex:** add Codex harness support and refactor for multi-harness CLI ([#38](https://github.com/martinffx/atelier/issues/38)) ([ce381d2](https://github.com/martinffx/atelier/commit/ce381d25c8b91734bf84288e1c9522e1a914a5b9))
+* **opencode:** add OpenAI provider support ([3f956bd](https://github.com/martinffx/atelier/commit/3f956bd0fb371a00147d2a92c5503d0c853215e2))
+
+
+### Bug Fixes
+
+* **code-handoff:** write handoffs to project directory ([abd6ec9](https://github.com/martinffx/atelier/commit/abd6ec90cbe614cedff3b0a2059ca9c6743d35ba))
+
+## [1.3.0](https://github.com/martinffx/atelier/compare/v1.2.2...v1.3.0) (2026-07-17)
+
+
+### Features
+
+* **code-pull-request:** add comment and merge workflows with progressive disclosure ([53e8957](https://github.com/martinffx/atelier/commit/53e89574ae1c37d0c3e868c7bbecee560e38c573))
+* **code:** add code-pull-request skill for PR creation ([62e32a6](https://github.com/martinffx/atelier/commit/62e32a6373be02cfad5fd3cb3fa248efcf3cc06c))
+* **code:** add code-pull-request skill for PR creation ([e4d2475](https://github.com/martinffx/atelier/commit/e4d24752f610177d6706cf382f3db3c9f5406355))
+* **skills:** split oracle-grillme into oracle-grill-me and oracle-domain-modelling ([#40](https://github.com/martinffx/atelier/issues/40)) ([e373c12](https://github.com/martinffx/atelier/commit/e373c12d05d9cde3ddb02fb0fc26ee770fb959a2))
+* **spec-brainstorm:** add section-by-section design approval ([f66eb62](https://github.com/martinffx/atelier/commit/f66eb6275780768300218d329bff8882b6d20e5d))
+* **spec-brainstorm:** add section-by-section design approval ([9cfb7e7](https://github.com/martinffx/atelier/commit/9cfb7e732fe20c546c2465218a8392dcba7859ad))
+
+
+### Bug Fixes
+
+* **code-pull-request:** correct description contract and base-branch detection ([73d48c6](https://github.com/martinffx/atelier/commit/73d48c6652f14bcc5224d91e546d219816d27e03))
+* **code-pull-request:** resolve code-review findings ([fda9086](https://github.com/martinffx/atelier/commit/fda90860b99ef7ed2fd0731785af0b27251e5d1f))
+* **skills:** address review findings from skill consolidation ([cccb1f8](https://github.com/martinffx/atelier/commit/cccb1f8430de7b699900c70d1b33207d771ac664))
+
 ## [1.2.2](https://github.com/martinffx/atelier/compare/v1.2.1...v1.2.2) (2026-05-23)
 
 

package/README.md

@@ -8,30 +8,29 @@
 
 A personal development toolkit for AI agents - spec-driven development, code quality, deep thinking, and ecosystem patterns.
 
+Atelier ships as a set of skills installed via `npx skills` plus a small CLI that generates harness-native agent definitions and configuration.
+
 ## Quick Start
 
-Install Atelier with a single command. It auto-detects your AI harness (Claude Code or OpenCode), configures agents, and sets up session hooks:
+Install Atelier with a single command. It configures agents and harness-native settings for Claude Code, OpenCode, or Codex:
 
 ```bash
-# Initialize atelier in your project
-bunx atelier@latest init
-
-# Or install everything including skills
-bunx atelier@latest init --all
+# Initialize atelier for your harness
+npx @martinffx/atelier@latest init --harness <claude|opencode|codex>
 
 # Non-interactive mode (CI/CD)
-bunx atelier@latest init --yes
+npx @martinffx/atelier@latest init --harness <claude|opencode|codex> --yes
 ```
 
 That's it. Your project is now configured for spec-driven development.
 
 ## What Gets Installed
 
-Atelier sets up three things in your project:
+Atelier sets up two things:
 
-### 1. Skills (34 available)
+### 1. Skills (28 available)
 
-Specialized knowledge modules that auto-invoke based on context. Install them via the CLI (`--all` flag) or separately:
+Specialized knowledge modules that auto-invoke based on context. Install them separately:
 
 ```bash
 npx skills add martinffx/atelier
@@ -41,22 +40,15 @@ npx skills add martinffx/atelier
 
 Harness-agnostic agent definitions configured with appropriate models:
 
-| Agent | Role | Claude | OpenCode |
-|-------|------|--------|----------|
-| **Scout** | Fast codebase reconnaissance | haiku | deepseek-v4-flash |
-| **Oracle** | Strategic thinking, requirements, analysis | opus | kimi-k2.6 |
-| **Architect** | DDD, system design, architecture | opus | deepseek-v4-pro |
-
-Agents are generated into `.claude/agents/` or `.opencode/agents/` with harness-specific model identifiers.
-
-### 3. Session Hooks
-
-Context injection that runs on every session start, clear, or compact:
+| Agent | Role | Claude | OpenCode | Codex |
+|-------|------|--------|----------|-------|
+| **Recon** | Fast codebase reconnaissance | haiku | deepseek-v4-flash | gpt-5.6-luna |
+| **Oracle** | Strategic thinking, requirements, analysis | opus | kimi-k2.6 | gpt-5.6-sol |
+| **Architect** | DDD, system design, architecture | opus | deepseek-v4-pro | gpt-5.6-sol |
 
-- **Claude Code**: `hooks/atelier-session-start` outputs project context as JSON
-- **OpenCode**: `.opencode/plugins/atelier.js` provides config and transform hooks
+Agents are generated into harness-specific locations (`.claude/agents/`, `.opencode/agent/`, `.codex/agents/`) with harness-native model identifiers.
 
-### 4. Task Tracking (optional)
+### 3. Task Tracking (optional)
 
 The spec workflow skills support **beads** for dependency-aware task tracking:
 
@@ -69,20 +61,24 @@ npm install -g beads
 
 **Fallback:** If beads isn't installed, skills fall back to the harness's native todo system (TodoWrite for Claude Code, built-in todos for OpenCode).
 
-### 5. Configuration
+### 4. Configuration
 
 Single source of truth in `.atelier/config.json`:
 
 ```json
 {
   "version": "1.0.0",
-  "harness": "claude",
   "skills_source": "martinffx/atelier",
-  "agents": [
-    { "template": "scout", "model": "haiku" },
-    { "template": "oracle", "model": "opus" },
-    { "template": "architect", "model": "opus" }
-  ]
+  "skills_path": "~/.agents/skills",
+  "claude": {
+    "provider": "anthropic",
+    "default_model": "opusplan",
+    "agents": [
+      { "template": "recon", "name": "recon", "model": "haiku" },
+      { "template": "oracle", "name": "oracle", "model": "opus" },
+      { "template": "architect", "name": "architect", "model": "opus" }
+    ]
+  }
 }
 ```
 
@@ -90,45 +86,43 @@ Single source of truth in `.atelier/config.json`:
 
 ### `init` (default)
 
-Initialize atelier in the current project.
+Initialize atelier for a single harness. Each invocation configures one harness; run it multiple times to configure several.
 
 ```bash
-bunx atelier@latest init [options]
+npx @martinffx/atelier@latest init --harness <claude|opencode|codex> [options]
 ```
 
 **Options:**
-- `--harness <type>` - Force harness type (`claude` or `opencode`)
-- `--all` - Also install skills via `npx skills add`
+- `--harness <type>` - Harness type (`claude`, `opencode`, or `codex`)
 - `--yes` - Non-interactive mode with default models
-- `--project` - Install skills in project directory (default: global)
 
-**Idempotent**: Re-running `init` is safe. It regenerates files without deleting anything unless you switch harnesses.
+**Idempotent**: Re-running `init` for the same harness is safe. It regenerates files without deleting anything unless you switch harnesses.
 
 ### `update`
 
-Refresh hooks and agents from the latest templates without touching skills:
+Refresh agents and harness-native config for one harness without touching skills:
 
 ```bash
-bunx atelier@latest update
+npx @martinffx/atelier@latest update --harness <claude|opencode|codex>
 ```
 
 ### `remove`
 
-Remove all atelier-generated files from the project:
+Remove all atelier-generated files for one harness:
 
 ```bash
-bunx atelier@latest remove
+npx @martinffx/atelier@latest remove --harness <claude|opencode|codex>
 ```
 
 Skills remain installed. Run `npx skills remove martinffx/atelier` to remove them separately.
 
 ## Skills
 
-This repository includes 34 skills that enhance AI agents with specialized knowledge and workflows.
+This repository includes 28 skills that enhance AI agents with specialized knowledge and workflows.
 
 ### Installing Skills
 
-If you didn't use `--all` during init, install skills manually:
+Install skills manually:
 
 ```bash
 # Install all skills
@@ -148,7 +142,7 @@ Skills fall into four categories based on what they do:
 
 Process-oriented skills that guide you through structured development workflows. These produce artifacts and should be followed step-by-step.
 
-- `spec-brainstorm` → `spec.md` — Discovery, requirements, architecture
+- `spec-brainstorm` → `design.md` — Discovery, requirements, architecture
 - `spec-plan` → `plan.json` — Break spec into implementable tasks
 - `spec-implement` — Execute tasks with TDD
 - `spec-finish` — Validate, review, prepare for PR
@@ -158,13 +152,9 @@ Process-oriented skills that guide you through structured development workflows.
 
 Analytical skills that provide patterns, principles, and deep reasoning. These adapt to your specific situation.
 
-- `oracle-architect` — DDD, hexagonal architecture, component design
-- `oracle-challenge` — Challenge assumptions, validate decisions
-- `oracle-doubt` — Adversarial review of non-trivial decisions
-- `oracle-grillme` — Socratic interrogation of plans against domain model
-- `oracle-security` — Security architecture and threat modeling
-- `oracle-testing` — Stub-driven TDD, layer boundary testing
-- `oracle-thinkdeep` — Extended sequential reasoning for complex problems
+- `oracle-debug` — Systematic debugging, root cause before fixes
+- `oracle-grill-me` — Socratic interrogation of plans against domain model
+- `oracle-domain-modelling` — Build and sharpen the project's domain model
 
 #### Domain Knowledge (`python:*`, `typescript:*`)
 
@@ -195,9 +185,8 @@ Technology-specific patterns and best practices. These are like having a senior
 Task-specific tools you invoke when you need them.
 
 - `code-commit` — Generate and validate conventional commits
-- `code-debug` — Systematic debugging workflow
-- `code-docs` — README, API docs, changelog generation
 - `code-handoff` — Compact conversation into handoff document
+- `code-pull-request` — Create, comment on, and merge GitHub pull requests or GitLab merge requests
 - `code-review` — Multi-agent code review with specialized reviewers
 - `code-subagents` — Dispatch patterns for parallel implementation
 
@@ -227,9 +216,10 @@ Skills are organized into four categories based on their role:
 
 ```mermaid
 graph LR
-    A[spec-brainstorm] -->|spec.md| B[spec-plan]
+    A[spec-brainstorm] -->|design.md| B[spec-plan]
     B -->|plan.json| C[spec-implement]
     C --> D[spec-finish]
+    D -.->|invokes| E[code-pull-request]
     
     B -.->|design flaw| A
     C -.->|missing tasks| B
@@ -238,10 +228,10 @@ graph LR
 ```
 
 **Standard flow:**
-1. **Research** - Discovery + research + architecture → `spec.md`
+1. **Research** - Discovery + research + architecture → `design.md`
 2. **Plan** - Break into tasks → `plan.json`
 3. **Implement** - Execute with TDD
-4. **Finish** - Validate and review
+4. **Finish** - Validate, review, and open the PR
 
 **Iteration is normal** - Backflows (dotted lines) are expected when:
 - Planning reveals design flaws → back to research
@@ -257,9 +247,11 @@ graph LR
 | "Write a plan" | spec-plan |
 | "Implement this" | spec-implement |
 | "Review this code" | code-review |
-| "Debug this" | code-debug |
-| "How should I test this" | oracle-testing |
-| "What's the architecture" | oracle-architect |
+| "Open a PR" | code-pull-request |
+| "Merge this PR" | code-pull-request |
+| "Read PR comments" | code-pull-request |
+| "Leave a comment on the PR" | code-pull-request |
+| "Debug this" | oracle-debug |
 
 ## Development
 

package/agents/architect.md

@@ -25,7 +25,7 @@ Before finishing, confirm you have:
 - [ ] Specified API endpoints with methods, paths, and request/response contracts
 - [ ] Listed error cases and handling strategy
 - [ ] Broken work into dependency-ordered tasks (entity → repository → service → router)
-- [ ] Written or updated the Technical Design section in `spec.md`
+- [ ] Written or updated the Technical Design section in `design.md`
 - [ ] Written or updated `plan.json` with the task breakdown
 
 ## Boundaries

package/agents/oracle.md

@@ -28,7 +28,7 @@ Before finishing, confirm you have:
 - [ ] Documented business rules, validations, and limits
 - [ ] Defined scope—what is included and what is explicitly out of scope
 - [ ] Generated 2–3 alternative approaches with trade-offs if the problem is complex
-- [ ] Written or updated the Requirements section in `spec.md`
+- [ ] Written or updated the Requirements section in `design.md`
 
 ## Boundaries