Replace alcode, alproject, plans-share and the content of the alignfirst skill with one globally installed CLI, @paleo/alignfirst, and embed docmap in it.
Commands
alignfirst guide [protocol] # core guide, or core guide + one protocol; --protocol-only drops the core
alignfirst ticket <id> # resolve TASK_DIR, restore from _archives, list entries
alignfirst ticket --side # reserve the next side-N
alignfirst sync # synchronize the team plans repository
alignfirst plans <subcommand> # setup, check, archive
alignfirst docmap [...] # the docmap CLI, unchanged
alignfirst project <subcommand> # discover and manage local projects
alignfirst code <subcommand> # alcode, gated by ALIGNFIRST_CODE_AGENT
alignfirst doctor # versions, plans mode, manifest, skills, agent config
Key points
- The eight skills become stubs that run
alignfirst guide <protocol>; slash commands and model triggers stay in the skills.
guide renders the protocols for the current project. guide review --reviewer <perspective> [--module <name>...] composes a reviewer subagent's prompt, replacing the file paths the orchestrator hands over today.
ticket replaces the three implementations of the .plans layout: the skill prose, alcode's side tickets, plans-share's archives.
- A committed
.alignfirst.json holds portable project facts: ticketPattern, plans.folder, portRange. It also marks the project for project discovery. A required .alignfirst-projects.json marks each projects directory, carries its description and port range, and bounds the scan; it replaces ~/.alproject.json and alproject-guide.md.
.plans stays a symlink into the team plans clone. @paleo/workspace stays the only project devDependency.
- Tool manuals keep their
--guide flag: alignfirst code --guide, alignfirst docmap --guide.
- The existing bins remain as compatibility aliases during the migration.
Replace
alcode,alproject,plans-shareand the content of thealignfirstskill with one globally installed CLI,@paleo/alignfirst, and embed docmap in it.Commands
Key points
alignfirst guide <protocol>; slash commands and model triggers stay in the skills.guiderenders the protocols for the current project.guide review --reviewer <perspective> [--module <name>...]composes a reviewer subagent's prompt, replacing the file paths the orchestrator hands over today.ticketreplaces the three implementations of the.planslayout: the skill prose, alcode's side tickets, plans-share's archives..alignfirst.jsonholds portable project facts:ticketPattern,plans.folder,portRange. It also marks the project forprojectdiscovery. A required.alignfirst-projects.jsonmarks each projects directory, carries its description and port range, and bounds the scan; it replaces~/.alproject.jsonandalproject-guide.md..plansstays a symlink into the team plans clone.@paleo/workspacestays the only project devDependency.--guideflag:alignfirst code --guide,alignfirst docmap --guide.