v1.1.1 — Fix init failing on missing role files

A packaging fix for 1.1.0: ambykit init failed for everyone installing from npm.

Fixed

1.1.0 left the default role definitions (src/roles/) out of the published package, so init stopped after the prompts with:

✗ ENOENT: no such file or directory, open '.../node_modules/@ambystech/ambykit/src/roles/pm.md'

The role files now ship with the package. A new test runs npm pack --dry-run and fails if any file the CLI reads at runtime (prompts, templates, roles, reference) is missing from the tarball, so this can't come back unnoticed. The rest of the suite runs against the repo checkout, which is why it slipped through.

If init failed for you on 1.1.0, run it again:

npx @ambystech/ambykit@latest init

Also

• The npm package now also ships LICENSE, CHANGELOG.md, and docs/.

Full changelog: v1.1.0...v1.1.1

v1.1.0 — Converge, worktree isolation, and multi-agent roles

Three new capabilities: a phase that verifies your code against the spec, per-feature git worktrees for parallel work, and roles that give each phase a discipline's perspective.

New phase: /amby.converge

Closes the loop after /amby.implement. It checks the codebase against every FR-###, SC-###, plan decision, and checked-off T###, classifying each as covered, gap, or unverified, then appends one unchecked task per gap under a ## Convergence section in tasks.md ([VERIFY] for inconclusive items) and marks fully covered stories done.

• Append-only and idempotent: with nothing to add, tasks.md is left byte-for-byte unchanged, and a second run never duplicates a task.
• It can't edit source — the phase is emitted with read/edit tools only, and writes are limited to that feature's tasks.md and spec.md status lines.
• Loop implement → converge until it reports converged.

New verb: ambykit worktree

Per-feature git worktrees so several features — or several assistants — progress side by side without checkout switching.

ambykit worktree 004-slug          # .worktrees/004-slug on branch 004-slug
ambykit worktree list              # feature, branch, clean/dirty/merged, path
ambykit worktree remove 004-slug   # removes the working copy; the branch is kept

• New branches start from the repository's default branch; .worktrees/ is added to .gitignore automatically.
• Creating twice is a no-op, removing a missing one exits 0, and a dirty worktree needs --force.
• Inside a worktree, phases resolve "the current feature" from the directory name.
• Enable automatic creation from /amby.specify by answering yes at ambykit init, or set "worktrees": true in .amby/config.json.
• ambykit check flags worktrees whose branch is already merged.

Multi-agent roles and /amby.review

Each phase now acts as a role defined in .amby/roles/<id>.md — Product Manager, UX Designer, Architect, Tech Lead, Developer, QA — shipped as defaults, installed write-if-absent, and yours to edit.

• Phases load only their own role, by path, so edits take effect without re-syncing commands.
• --as <id> on any phase gives a one-run alternative perspective; an unknown id is refused with the list of defined roles.
• /amby.review <artifact> [--as <role>] [--apply] has a different role critique an artifact: findings keyed by stable ID with severity and a suggested fix, read-only unless --apply, which patches in place (IDs preserved) and appends a ## Reviews record. Advisory — no phase waits on a review.
• ambykit sync warns when a role exceeds 150 words and refuses duplicate ids; ambykit check also reports defaults you deleted.
• Roles are emitted as native sub-agents for the targets whose format is verified against official docs: .claude/agents/, .opencode/agents/, and .github/agents/.

Projects without .amby/roles/ are unaffected — commands emit exactly as before.

Also

• Worktree paths are canonicalized before comparison with git's output, fixing worktree create/list/remove on macOS (/var symlink) and Windows (8.3 short paths).
• The workflow diagram, phase pages, README, and docs/ cover all eleven phases and nine CLI verbs, kept honest by the docs-sync checker.

Full changelog: v1.0.0...v1.1.0

v1.0.0 — Brownfield support, /amby.revise, and self-update

First stable release of AmbyKit.

Brownfield project support

ambykit init is now non-destructive. An existing CLAUDE.md / AGENTS.md is detected and preserved — AmbyKit adds and updates only its own ### AmbyKit usage section, idempotently. Before modifying an existing file it writes a timestamped backup under .amby/backups/, and a hand-edited AmbyKit section is left untouched and reported as skipped.

• ambykit restore [file] rolls an agent-doc file back from its backup.
• Preview any run with --dry-run.
• Add .amby/backups/ to your .gitignore.

New phase: /amby.revise

Continues an existing feature's spec (or ui.md) in place — adds user stories, requirements, and success criteria and refines existing ones while preserving every stable ID. Distinct from /amby.specify (new feature) and /amby.clarify (markers only). If the spec is already done it makes no edits and points you back to /amby.specify.

Self-update

• ambykit update updates the CLI, then refreshes the project's generated prompts.
• An outdated-version callout appears when a newer release is published, backed by a 24h cached registry lookup that never blocks the hot path.

Also

• codex added to the package keywords.
• src/cli reorganized: UI and IO grouped, emit moved to core.
• Docs cover the full nine-phase workflow and all eight CLI verbs, with the docs-sync checker extended to keep the README, docs/, the workflow overview, and AGENTS.md from drifting.

Full changelog: v0.2.0...v1.0.0

v0.2.0 — Codex CLI support

Highlights

OpenAI Codex CLI is now a supported AmbyKit target. ambykit init / ambykit sync can emit Codex-native files: the skills command surface (.agents/skills/amby-*/SKILL.md) plus a native AGENTS.md rules file.

What's new

• Codex emitter (src/emitters/codex.ts) — a thin BaseEmitter subclass registered in the target→emitter map. $ARGUMENTS is rewritten to free-text prose, since Codex skills have no placeholder convention.
• Cross-platform fixes — path handling in src/core/paths.ts and src/cli/fsops.ts normalized so emitted paths and fs operations behave on Windows as well as POSIX. CI matrix extended to cover it.
• Docs & site — docs/tool-compatibility.md, the site compatibility page, and the tool cards now list Codex.
• Dogfooding — this repo's own .amby/config.json adds codex, so .agents/skills/ is generated by ambykit sync.

Full spec: specs/008-codex-integration/.

Full changelog: v0.1.1...v0.2.0

v0.1.1

Full Changelog: v0.1.0...v0.1.1

v0.1.0

What's Changed

• feat(cli): enhanced terminal UI (feature 006) by @tavobarrientos in #1
• feat(site): AmbyKit documentation site (feature 007) by @tavobarrientos in #2

New Contributors

• @tavobarrientos made their first contribution in #1

Full Changelog: https://github.com/ambystechcom/AmbyKit/commits/v0.1.0