Team Boot

team-boot

Overview

Assembles team AI directives context and injects it into the system prompt at session start. The CDR index lists all available team context modules with descriptors — read full module files on demand when a task matches.

team-boot injects only the always-relevant layer: constitution titles, the compact CDR index, the Class Boots catalog, the skills registry, and MCP servers. The four record classes (ADR/PDR/ChDR/CDR deep-dive) plus technology selection load on demand through the class boots below — each pairs its index injection with decision capture.

Discovery is native: the injected CDR index is matched by the LLM against the current task on its own, per prompt, with no skill invocation. /team-discover is a separate, user-invoked command for explicit structured re-discovery (e.g., starting a complex feature) and is not part of the bootstrap loop.

Fast path: if the team AI directives context (constitution, CDR index, Class Boots catalog) is already in your system prompt or first user message, the event hook already ran — do nothing.

Class Boots

Invoke a class boot when a task or decision matches its row — invoke it at the START of the matching task, before planning the todo list and before implementation, so the class context informs planning. Never defer to session end. When no local memory index exists in the current working directory and the directory sits inside a workspace (detected via a .gitmodules marker in an ancestor), the boot reads the workspace root's docs/adlc/memory/ index instead. Each boot emits its class context section and its own searched line (_Searched N <class> records, K matched._), and carries the full detection and capture guidance for its class. 0 rows matched → the boot emits its section heading + the searched line only — no table.

Event hook (automatic)

The session_start and session_compact event hooks (declared in .events.json, wired by adlc-cli) run scripts/boot.sh (POSIX) or scripts/boot.ps1 (Windows), which reads .adlc/init-options.json, assembles the context block (constitution, CDR.md index table, .skills.json), and outputs it to stdout. The plugin caches the result and pushes it into the system prompt on every step (idempotent — same cached content, no accumulation). The session_compact declaration makes post-compaction re-injection part of the contract: when a harness summarizes history, the generated plugin re-runs the handler and the dedup guard prevents double-injection. Agents whose adapters don't map session_compact yet skip it — adlc-cli owns those mappings.

Manual fallback (agents without event support)

1. Read .adlc/init-options.json from the current working directory. Do NOT walk up parent directories. Do NOT use glob, find, or any file-search tool to locate it.
2. If unconfigured (missing, null, or path doesn't exist): invoke the team-setup skill.
3. If configured: assemble the context and follow the Class Boots catalog above. Full walkthrough in references/manual-fallback.md.

Decision Capture

Detect decisions as they emerge and write lightweight drafts directly to .adlc/drafts/{type}/ during the session — no specify skill invocation needed. The only gate is clarify at session end.

Detection Triggers

Proportionality gate and trust model in references/decision-capture.md: match documentation depth to how non-obvious the decision is, and synthesize project knowledge — never transcribe instructions.