Skip to content

Unify the AlignFirst tooling into one alignfirst CLI #78

Description

@paleo

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions