Skip to content

README.md

Latest commit

 

History

History
66 lines (41 loc) · 2.74 KB

README.md

File metadata and controls

66 lines (41 loc) · 2.74 KB
Raw

Reference

Documentation for the facilitator — the role that translates the product thinker's why into AI-executable engineering work. For the product-thinker introduction, see the project README.

In this folder

File What it covers
facilitator.md The role in detail — how to bootstrap a brief, classify intents, run fidelity reviews, drive lifeboat / launch / audit.
commands.md Full command surface — every command, every sub-verb, every flag.

Onboarding: which command to start with

Three onboarding paths, depending on what the project is starting from.

If the directory has… Run
A lifeboat from another abcd project (a portable rebuild seed) /abcd:embark from <path>
A GitHub Spec Kit project to import as starter intents /abcd:embark from-spec-kit <path>
An existing project to add abcd on top of /abcd:ahoy install
Nothing (empty or near-empty) /abcd:init-project scaffold

/abcd:ahoy install is idempotent — covers first-install and upgrade. Use it freely.

Command categories

The full surface groups into three rough families. One example per family below; full reference in commands.md.

Onboarding

Putting abcd into a project for the first time, upgrading it, or rebuilding from a portable seed.

/abcd:ahoy install        # add abcd to an existing project

Commands: /abcd:ahoy, /abcd:init-project, /abcd:embark.

The lifecycle

Capturing intents, planning them into engineering work, shipping them, and grading delivered reality against the original promise. Plus the lightweight ledger for things spotted mid-flight.

/abcd:intent new "customers earn a free coffee on every 10th purchase"

Commands: /abcd:intent (and its sub-verbs — new, refine, grill, plan, ship, review, consistency, shape, reclassify, link, list), /abcd:capture.

Operational

Packing portable rebuild seeds, promoting private dev repos to public, vendoring OSS with provenance, running compliance audits, milestone retrospectives, cross-corpus synthesis, and the top-level dispatcher.

/abcd:disembark to home   # pack a lifeboat into this repo's .abcd/lifeboat/

Commands: /abcd, /abcd:disembark, /abcd:launch, /abcd:loot, /abcd:audit, /abcd:dredge, /abcd:reflect.

Convention

Every command, when called with no arguments, shows help and a status summary. Bare invocation never mutates state; every state-changing operation requires an explicit sub-verb.

See also