---
description: Bootstrap or upgrade the agent-workflow-kit AI memory & workflow system (docs/ai + AGENTS.md + enforcement) in this project.
---

<!-- agent-workflow-kit:managed — generated by the kit installer. Safe to overwrite on
     reinstall; delete this file to remove the Devin Desktop launcher. -->

# agent-workflow-kit

Thin launcher — the full algorithm, templates, and scripts live in the kit. Do **not**
reinvent any of it here; the kit's `SKILL.md` is the single source of truth.

`<KIT_DIR>` = the kit's directory on this machine (the installer substitutes the real path).

## Steps

1. Read the kit instructions in full: `<KIT_DIR>/SKILL.md` (the thin router), plus the
   `references/` files it points to — the chosen mode's `<KIT_DIR>/references/modes/<mode>.md`
   and any `references/shared/` files that mode's `Requires:` line names. Wherever it says
   `${CLAUDE_SKILL_DIR}`, read that as `<KIT_DIR>`.
2. Pick the mode:
   - No `docs/ai/` in this project → **bootstrap**.
   - `docs/ai/` already exists → ask the user whether to run **upgrade** instead.
3. Execute every step from `SKILL.md` for THIS repository:
   - Recon (read-only) → **ask the three setup questions (visible-or-hidden / language /
     attribution) as ONE structured multi-question prompt; record each answer individually,
     write nothing until ALL are answered** →
     create `AGENTS.md` (+ `CLAUDE.md` symlink) from `<KIT_DIR>/references/templates/` →
     deploy `docs/ai/` → copy `<KIT_DIR>/references/scripts/*.mjs` (Node projects) →
     wire/hide per visibility → install the pre-commit hook → stamp `docs/ai/.workflow-version`.
4. Report what was filled with real data vs left as TODO, then **ask before committing** —
   never auto-commit.

This workflow is manual-only; run it deliberately, like a deploy.