Repository navigation
v0.6.0 — flow chain + one skill tree for Claude Code and Codex + two-question /bootstrap
LatestAdded
- One skill tree for every agent. Skills live once in
.agents/skills/<name>/;.claude/skills/<name>is a relative symlink into it, so Claude Code, Codex, Cursor and other AGENTS.md-aware tools load the same files.AGENTS.mdstays a symlink toCLAUDE.md. Newscripts/link-agent-skills.mjskeeps the links in sync, run by the pre-commit hook. - Planning and build skills (the flow chain).
/flowpicks the path;/grilling,/grill-meand/grill-with-docssharpen an idea by interview;/to-specand/to-ticketsturn it intospec.mdandtickets/NN-slug.mdin the project;/implementbuilds one ticket per session. On-ramps:/triage,/diagnosing-bugs,/wayfinder. Underneath:/domain-modeling,/codebase-design,/tdd,/code-review,/prototype,/research,/handoff. All resolve the project and paths fromdocs/agents/project-context.md. Adapted from mattpocock/skills (MIT, seeTHIRD-PARTY-NOTICES.md). With/entity-researchbelow, the bundle grows from 29 skills to 47. /entity-research— company and person research from public web sources, with citations.- Codex gets the same MCP servers.
.codex/config.tomlis generated from.mcp.json(API keys forwarded, opt-in servers left commented out; Slack isn't available in Codex yet) and the pre-commit hook regenerates it once you've runbash scripts/install-git-hooks.sh;node scripts/codex-config-from-mcp.mjsrefreshes it by hand. Hooks stay Claude Code only. /migrate-workreads Codex sessions too, alongside Cowork, the Code tab and Claude Code. A folder you worked on from both Claude and Codex shows up as one project, and the census says which session stores it found. It also brings over what Claude and Codex already remember about you (your global instructions, Claude Code's auto-memory, Codex's memories): facts about you go toUSER.md, how the assistant should work toSOUL.md, project notes to that project'smemory.md. Every line is shown first, appended word for word, and duplicates, conflicts and anything that looks like a credential are held back.- Hooks:
inject-projects(SessionStart — injects the active-project and Area-app table) andworkspace-guards(append-only daily memory, no outputs at the repo root). Both read workspace paths from the Configuration block.
Changed
- Configuration:
workspace.codingand thecode_projectsindex are gone. Code lives inworkspace.area_apps(shipped Area apps) andworkspace.project_apps(a COD project'sapp/), both gitignored. /bootstrapre-runs by deleting thesetup_completedline; there is no--reconfigureflag./bootstrapasks two questions (who you are; your assistant's name and feel) and works out the rest: git name and email, timezone and language (a bundled script), plus which connectors are live. The script fills the persona files and Configuration block and verifies nothing is left unresolved. A persona file that no longer matches its template keeps your text, with its names filled in if you choose. Writing-voice capture,/migrate-workand the Slack, Atlassian and Figma connectors are offered at the end instead of asked up front; the connectors are added byapply.py add-connectors, which also refreshes the Codex config. Fixed: fresh forks were treated as already configured, because the template's placeholder date counted.external-action-guardalso asks before Gmail send/reply/forward, iMessage and Slack canvases.pre-compactauto-handoffs record tool calls, edited files and errors again;tldr-readworks with tldr 1.5.2.- Skill evals no longer ship (maintainer test data); write your own with
/skill-creator. /briefingreads mail and calendar through your Gmail and Calendar connectors (connect Google Workspace with/mcp) instead of thegwsCLI./migrate-workon a workspace that hasn't been through/bootstrapstops and points you there, instead of writing raw<placeholders>into your files./migrate-workstays readable on a machine with years of history: past 40 memory lines, the approval shows each destination's count and first lines and puts the full numbered list in a file you can open; candidates beyond four are picked by number. Memories that are about a different person or assistant are held back, quoted YAML values are unescaped, and dated journal files in a memory folder are skipped.scripts/install.shnow installs the git hooks and the packages for the bundled image-analysis server, and the README setup runsbash scripts/install-git-hooks.sh.
Removed
- Hooks
post-edit-diagnosticsandauto-handoff-stop. - The
3-Coding/folder from the README map and every folder README. - The
.claude/commands/use-design.mdslash command, which hardcodedworkspace/4-Resources/; the/use-designskill does the same job and follows your Configuration. Delete the command file from a 0.5.x fork so the skill answers/use-design. - The
oracleandworkersubagents in.claude/agents/:oraclesearched only through the Python sandbox removed in 0.5.0, andworkerneeds an orchestrator that doesn't ship. Delete.claude/agents/and.claude/tools/from a 0.5.x fork unless you use them.
Fixed
THIRD-PARTY-NOTICES.mdnow credits the 14design-*skills (adapted from open-design, Apache 2.0) andskill-creator(Apache 2.0), with what was changed. Earlier releases shipped the design skills without their license..claude/settings.local.json(your own permission grants) is now gitignored, sogit add -Ano longer picks it up..claude/settings.jsonno longer ships permission rules or enabled plugins from the maintainer's own setup.- In Codex,
gemini-visionstarts from the repo root, so it works when Codex runs in a subfolder. /code-reviewnow shows up in Codex: its description wasn't valid YAML, which Claude Code tolerates and Codex silently skips.gemini-visionfailed to start on a fresh clone because its packages were never installed; the README and.claude/mcp-servers/README.mdnow say to runnpm install --prefix .claude/mcp-serversonce.scripts/install.shon a Mac without Homebrew: brew wasn't found right after installing it, every failed step printeddie: command not found, and a missingghfailed the whole install. All three fixed.- Hooks treat an unfilled
<workspace.root>as the defaultworkspace, so they work before/bootstrap; creating today'smemory/YYYY-MM-DD.mdwith Write is no longer blocked (overwriting an existing one still is);tldr-readno longer runs the file path through a shell and only pre-approves reads inside the project. .gitignorekeeps code (app/,apps/) and handoffs ignored after you rename the workspace folder.- Skills no longer say HQ,
/retro-project,/contact-researchor/bootstrap (TBD);/archive-project's last step no longer contradicts its index step;/new-project'sCOD-rule matches where code lives. - The docs now match the thin-Areas model from 0.5.0. The
CLAUDE.mdtemplate, the new-projectCLAUDE.mdtemplate and the folder READMEs had still described Areas holding aresources/folder and archived projects promoting files into them; now an Area holds only its rules, memory and generated index, and archived projects move whole. They also use thePROJ-/COD-/VID-project names/new-projectcreates, without pre-madeinputs/working/outputsfolders. INSTALL.mdmatches the two-question/bootstrap: no tool-probe panel and no connector picker./bootstrapno longer reads the installer'sSBOS_TIERmarker. It also now says to runbash scripts/install-git-hooks.shonce.- Docs no longer point at skills that don't ship (
/meeting-prep,/contact-add,/weekly-digest,/standup, the old ContinuousClaude skill list). /os-guidepoints at sections that exist in a fork (several rows cited maintainer-only README sections) and answers "how do I bring in my Codex work" and "does Codex get my MCPs".
Upgrading from 0.5.x
Skills moved from .claude/skills/ to .agents/skills/. Skills you never edited switch over on their own; the steps below cover the rest.
- Before you pull, copy any skill you edited to a folder outside the repo. An edited skill conflicts with the move, and the pull replaces it.
- Pull, taking the incoming version on conflicts in
.claude/skills/,.agents/skills/and.claude/settings.json; the old settings point at two hooks that no longer exist. Re-add any settings of your own afterwards. IfCLAUDE.mdconflicts (it will if/bootstrapfilled it in), keep your values. - Update the Configuration block in
CLAUDE.md: deleteworkspace.codingand theindexessection, and addworkspace.area_appsandworkspace.project_appsfrom the new template. Move anything in3-Coding/into an Area'sapps/<name>/(shipped apps) or a project'sapp/(code still being built); both are gitignored. - Put your edited skills back under
.agents/skills/<name>/, runbash scripts/install-git-hooks.shonce so the pre-commit hook keeps skills linked from now on, then runnode scripts/link-agent-skills.mjs. - Restart Claude Code so the new hooks load.
Full changelog: v0.5.0...v0.6.0