@event4u/agent-config 5.10.1 → 6.1.0

package/docs/distribution/public-install-smoke.md

@@ -63,6 +63,6 @@ These deviations are recorded here so a future maintainer reading the roadmap do
 ## See also
 
 - [`tests/test_one_liner_entrypoints.sh`](../../tests/test_one_liner_entrypoints.sh) — the smoke harness invoked per matrix leg.
-- [`scripts/install`](../../scripts/install) — the consumer-facing installer orchestrator.
+- [`scripts/install`](../../src/scripts/install) — the consumer-facing installer orchestrator.
 - [`.github/workflows/tests.yml`](../../.github/workflows/tests.yml) — the broader install integration matrix (Linux + macOS, 35 tests × 4 shards).
 - [`agents/roadmaps/road-to-product-adoption.md`](../../agents/roadmaps/road-to-product-adoption.md) — parent roadmap and acceptance criteria.

package/docs/distribution/registries.md

@@ -37,10 +37,10 @@ No bespoke `BREAKING_CHANGES.md` is maintained — the changelog is the authorit
 
 | # | Registry | URL | Submission shape | Status | PR link |
 |---|---|---|---|---|---|
-| 1 | `punkpeye/awesome-mcp-servers` | <https://github.com/punkpeye/awesome-mcp-servers> | One-line entry under the agent-tooling section, links to `README.md` hero anchor | ⬜ open | — |
-| 2 | `mcp.so` | <https://mcp.so/> | Submit via the directory form; same one-line shape | ⬜ open | — |
-| 3 | `mcpservers.org` | <https://mcpservers.org/> | Submit via the directory form; same one-line shape (verify URL current at submission time) | ⬜ open | — |
-| 4 | `glama.ai` | <https://glama.ai/> | Submit via the Glama claim flow; same one-line shape — repo `https://github.com/event4u-app/agent-config`, tags `agent-governance`, `mcp`, `skills` | ⬜ open (human-owner: maintainer submits via the Glama claim flow) | — |
+| 1 | `punkpeye/awesome-mcp-servers` | <https://github.com/punkpeye/awesome-mcp-servers> | One-line entry under the Developer-Tools section + Glama score badge | 🟡 PR open (awaiting maintainer review) | <https://github.com/punkpeye/awesome-mcp-servers/pull/6865> |
+| 2 | `mcp.so` | <https://mcp.so/> | Submit via the directory form; same one-line shape | ✅ submitted (maintainer-confirmed 2026-06) | — |
+| 3 | `mcpservers.org` | <https://mcpservers.org/> | Submit via the directory form; same one-line shape (verify URL current at submission time) | ✅ submitted (maintainer-confirmed 2026-06) | — |
+| 4 | `glama.ai` | <https://glama.ai/mcp/servers/event4u-app/agent-config> | Server page live; score badge embedded in the awesome-mcp-servers entry (PR #6865) | ✅ listed (server page + badge return HTTP 200, verified 2026-06-08) | <https://glama.ai/mcp/servers/event4u-app/agent-config> |
 
 ## Submission template
 
@@ -55,7 +55,7 @@ Use this exact text for the awesome-list entry. Adjust the link anchor per direc
 When the maintainer opens the PR / posts the directory entry, the
 description block carries the concrete reality the 3.2.0 review
 named. Reviewer verbatim quote: *"deutlich mehr vorzuweisen als bei
-jedem vorherigen Erwähnungszeitpunkt."* The numbers below mirror the
+jedem vorherigen Erwähnungszeitpunkt."* The numbers below mirror the  <!-- md-language-check: ignore -->
 3.2.0 release notes and the `task adoption:status` snapshot from
 that release; refresh them before posting if a later release has
 shipped.

package/docs/distribution/registry-submissions.md

@@ -66,7 +66,7 @@ in week 1 can age out by week 4.
 
 Each row's status contributes to the adoption-dimension score
 tracked in
-[`road-to-employee-product-and-external-proof.md`](../../agents/roadmaps/road-to-employee-product-and-external-proof.md)
+[`road-to-employee-product-and-external-proof.md`](../../agents/roadmaps/archive/road-to-employee-product-and-external-proof.md)
 Phase 0 § Adoption surface:
 
 - ≥ 1 row in `accepted` — adoption-dimension lifts from "scaffolded"
@@ -80,6 +80,6 @@ Phase 0 § Adoption surface:
 ## See also
 
 - [`registries.md`](registries.md) — submission template + audit cadence + Discussions setup.
-- [`scripts/mcp_registry_submit.sh`](../../scripts/mcp_registry_submit.sh) — automation for row 1.
+- [`scripts/mcp_registry_submit.sh`](../../src/scripts/mcp_registry_submit.sh) — automation for row 1.
 - [`mcp-submission-checklist.md`](mcp-submission-checklist.md) — MCP-specific pre-submission floor.
 - `task adoption:status` (Phase C Step 6) — one-screen adoption dashboard.

package/docs/end-to-end-walkthroughs.md

@@ -42,8 +42,8 @@ AC: signature multiply(a: int, b: int) -> int returning the product;
 plan, changes, test verdict, judge findings, suggested next command
 (`/commit`).
 
-**Anchored in:** [`commands/implement-ticket.md`](../.agent-src/commands/implement-ticket.md)
-(eight-step contract) · [`work_engine/dispatcher.py`](../.agent-src/templates/scripts/work_engine/dispatcher.py)
+**Anchored in:** [`commands/implement-ticket.md`](../dist/agent-src/commands/implement-ticket.md)
+(eight-step contract) · [`work_engine/dispatcher.py`](../dist/agent-src/templates/scripts/work_engine/dispatcher.py)
 (`STEP_ORDER`).
 
 ---
@@ -75,8 +75,8 @@ Add modulo(a, b) to src/calculator.py — return a % b for ints
 **Outcome** — `success`. The same dispatcher and judges as GT-1; only
 the input envelope (`input.kind="prompt"` vs `"ticket"`) differs.
 
-**Anchored in:** [`commands/work.md`](../.agent-src/commands/work.md) ·
-[`skills/refine-prompt/SKILL.md`](../.agent-src/skills/refine-prompt/SKILL.md)
+**Anchored in:** [`commands/work.md`](../dist/agent-src/commands/work.md) ·
+[`skills/refine-prompt/SKILL.md`](../dist/agent-src/skills/refine-prompt/SKILL.md)
 · [`docs/contracts/adr-prompt-driven-execution.md`](contracts/adr-prompt-driven-execution.md).
 
 ---
@@ -104,12 +104,12 @@ generic implement loop.
 | c6 | _(none)_ | delivery report, exit `0` |
 
 **Outcome** — `success`. The audit-first ordering is enforced by the
-[`ui-audit-gate`](../.agent-src/rules/ui-audit-gate.md) rule: any
+[`ui-audit-gate`](../dist/agent-src/rules/ui-audit-gate.md) rule: any
 non-trivial UI change without `state.ui_audit` halts before design.
 
 **Anchored in:** [`docs/ui-track-mental-model.md`](ui-track-mental-model.md) ·
-[`rules/ui-audit-gate.md`](../.agent-src/rules/ui-audit-gate.md) ·
-[`skills/existing-ui-audit/SKILL.md`](../.agent-src/skills/existing-ui-audit/SKILL.md).
+[`rules/ui-audit-gate.md`](../dist/agent-src/rules/ui-audit-gate.md) ·
+[`skills/existing-ui-audit/SKILL.md`](../dist/agent-src/skills/existing-ui-audit/SKILL.md).
 
 ---
 
@@ -147,9 +147,9 @@ the outcome-aware telemetry (`outcomes: ["blocked"]`, see
 [P2 #9](../agents/roadmaps/road-to-1-15-followups.md#phase-9--outcome-aware-telemetry-p2-9)).
 No work is committed, no auto-guess is taken.
 
-**Anchored in:** [`rules/ask-when-uncertain.md`](../.agent-src/rules/ask-when-uncertain.md)
-· [`rules/non-destructive-by-default.md`](../.agent-src/rules/non-destructive-by-default.md)
-· [`skills/refine-ticket/SKILL.md`](../.agent-src/skills/refine-ticket/SKILL.md).
+**Anchored in:** [`rules/ask-when-uncertain.md`](../dist/agent-src/rules/ask-when-uncertain.md)
+· [`rules/non-destructive-by-default.md`](../dist/agent-src/rules/non-destructive-by-default.md)
+· [`skills/refine-ticket/SKILL.md`](../dist/agent-src/skills/refine-ticket/SKILL.md).
 
 ---
 

package/docs/experiences/agency.md

@@ -0,0 +1,49 @@
+# 🏛 The `agency` experience
+
+> Set `profile.id: agency` (wizard, or `agent-config use --profile=agency`).
+> **Preset default: `strict`.**
+
+## Who it's for
+
+The multi-client delivery shop — refine a fuzzy client ask into an estimated,
+AC-tight ticket; turn a phase into a roadmap; ship per client without losing
+decision provenance.
+
+## First three tasks
+
+1. **Refine the client ask** — `/refine-ticket` rewrites the ticket and surfaces the top-5 risks.
+2. **Size and split** — `estimate-ticket` sizes and breaks the work down.
+3. **Anchor the trade-off** — `decision-record` writes an ADR before code starts.
+
+## First commands
+
+`/work` · `/implement-ticket` · `/refine-ticket` · `/feature` · `/roadmap`
+
+## Packs that activate
+
+`engineering-base` + `gtm-marketing` + `product-basic` + `ops-people`
+(+ `meta`, always on) — the broadest profile, for a shop that does delivery,
+positioning, and account work.
+
+## Flows that apply
+
+All four — [discovery → implementation → review → delivery](../flows.md) — run
+per client engagement. The `strict` preset keeps the gates tight across accounts.
+
+## What is NOT loaded
+
+No `finance-advanced`, no `ai-video`, no `founder-strategy`. Delivery-shop
+surface, not a CFO or studio one.
+
+## Example
+
+> *"Client wants 'a better dashboard' by next sprint."* → `/refine-ticket`
+> rewrites it AC-tight with top-5 risks; `estimate-ticket` splits it;
+> `decision-record` captures the charting-library trade-off before code.
+
+## See also
+
+[Profile (deep)](../profiles.md#profile-agency) ·
+[Role guide](../getting-started-by-role.md#consultant-advisory-freelance-fractional) ·
+[Flows](../flows.md) ·
+key skills: `refine-ticket` · `estimate-ticket` · `decision-record` · `doc-coauthoring` · `perf-feedback-craft`.

package/docs/experiences/content_creator.md

@@ -0,0 +1,47 @@
+# ✍️ The `content_creator` experience
+
+> Set `profile.id: content_creator` (wizard, or
+> `agent-config use --profile=content_creator`). **Preset default: `balanced`.**
+
+## Who it's for
+
+Writers, ghostwriters, marketers — draft in someone else's voice, plan a quarter
+of content, ship a launch, render a cinematic AI video.
+
+## First three tasks
+
+1. **Write in a voice** — `/ghostwriter` against a public-figure voice profile, or `/post-as` for your own (`.agent-user.md`).
+2. **Lock the brand frame** — `voice-and-tone-design` + `messaging-architecture` before any copy ships.
+3. **Render a video** — `/video:from-script` drives script → character-locked image → motion+audio → render → stitch (`AIV_DRYRUN=true` cost-safety default).
+
+## First commands
+
+`/work` · `/post-as` · `/ghostwriter` · `/optimize-prompt` · `/video:from-script` · `/video:storyboard` · `/video:scene` · `/video:stitch`
+
+## Packs that activate
+
+`gtm-marketing` + `ai-video` (+ `meta`, always on).
+
+## Flows that apply
+
+[Discovery](../flows.md) drives content planning (editorial calendar, messaging).
+The engineering flows (implementation / review / delivery) do not apply — the work
+is pack-skill-driven (voice, messaging, video), not a code journey.
+
+## What is NOT loaded
+
+No `engineering-base` (no `/implement-ticket`, `/review-changes` code judges),
+no `finance-*`, no `founder-strategy`. The surface is content + video.
+
+## Example
+
+> *"Draft a launch post in our founder's voice."* → `/post-as:me` writes against
+> `.agent-user.md`; `voice-and-tone-design` + `messaging-architecture` hold the
+> brand frame; `release-comms` shapes the announcement.
+
+## See also
+
+[Profile (deep)](../profiles.md#profile-content_creator) ·
+[Role guide](../getting-started-by-role.md#creator-writer-marketer-indie-content-shop) ·
+[Flows](../flows.md) ·
+key skills: `voice-and-tone-design` · `messaging-architecture` · `editorial-calendar` · `release-comms` · `character-consistency`.

package/docs/experiences/developer.md

@@ -0,0 +1,49 @@
+# 👩‍💻 The `developer` experience
+
+> Set `profile.id: developer` (the wizard's first question, or
+> `agent-config use --profile=developer`). **Preset default: `balanced`.**
+
+## Who it's for
+
+The IC engineer — implement a ticket end-to-end, fix CI red, self-review before
+the PR. Stack-aware across Laravel · Symfony · Next.js · React · Node.
+
+## First three tasks
+
+1. **Implement a ticket** — `/implement-ticket` refines it, plans, edits, tests, verifies.
+2. **Fix a red build** — `/fix:ci` reads the failure and drives it green.
+3. **Self-review the diff** — `/review-changes` dispatches five judges (bug, security, tests, quality, architecture).
+
+## First commands
+
+`/work` · `/implement-ticket` · `/review-changes` · `/fix` · `/commit`
+
+## Packs that activate
+
+`engineering-base` (+ `meta`, always on). Language/framework packs (laravel, php,
+react, …) overlay per session from the project's detected stack.
+
+## Flows that apply
+
+All four — this is the home profile for the developer journey:
+**[discovery](../flows.md) → implementation → review → delivery**.
+
+## What is NOT loaded
+
+No `gtm-marketing`, `ai-video`, `finance-*`, or `founder-strategy` packs — no
+ghostwriter, video, DCF, or fundraising surfaces. The profile stays focused on
+shipping code.
+
+## Example
+
+> *"Implement PROJ-412."* → `/implement-ticket` refines acceptance criteria,
+> plans the change, edits with `minimal-safe-diff`, runs the suite via
+> `test-driven-development`, and stops on fresh green evidence
+> (`verify-completion-evidence`) — then `/review-changes` before you open the PR.
+
+## See also
+
+[Profile (deep)](../profiles.md#profile-developer) ·
+[Role guide](../getting-started-by-role.md#developer-the-original-audience) ·
+[Flows](../flows.md) ·
+key skills: `developer-like-execution` · `verify-completion-evidence` · `minimal-safe-diff` · `systematic-debugging` · `test-driven-development`.

package/docs/experiences/finance.md

@@ -0,0 +1,48 @@
+# 💼 The `finance` experience
+
+> Set `profile.id: finance` (wizard, or `agent-config use --profile=finance`).
+> **Preset default: `strict`.**
+
+## Who it's for
+
+The CFO / fractional finance / FP&A lead — build a DCF, stress-test the plan,
+frame the runway call. Every output carries the finance safety floor (no final
+invest/raise verdict; assumptions + sensitivity + confidence band).
+
+## First three tasks
+
+1. **Value it** — `dcf-modeling` walks WACC / terminal-value / 5-year-hold reasoning.
+2. **Cut the scenarios** — `scenario-modeling` produces base / upside / downside.
+3. **Frame the runway** — `runway-cognition` shapes the fundraise-vs-cut-vs-grow decision.
+
+## First commands
+
+`/work` · `/council` · `/challenge-me`
+
+## Packs that activate
+
+`finance-basic` + `finance-advanced` (+ `meta`, always on).
+
+## Flows that apply
+
+[Discovery](../flows.md)-style modeling and framing dominate. The engineering
+flows (implementation / review / delivery) do not apply — finance work is
+pack-skill-driven and gated by the `finance-safety-floor` rule.
+
+## What is NOT loaded
+
+No `engineering-base`, no `ai-video`, no `gtm-marketing`, no `founder-strategy`.
+Pure finance surface.
+
+## Example
+
+> *"What's our runway if growth halves?"* → `runway-cognition` frames the shape;
+> `scenario-modeling` cuts base/downside; output ends with the mandatory
+> *"Not investment advice — figures are model output, sensitivity stated"* footer.
+
+## See also
+
+[Profile (deep)](../profiles.md#profile-finance) ·
+[Role guide](../getting-started-by-role.md#finance--ops-cfo-controller-ops-lead-founder-finance) ·
+[Flows](../flows.md) ·
+key skills: `dcf-modeling` · `forecasting` · `scenario-modeling` · `unit-economics-modeling` · `runway-cognition`.

package/docs/experiences/founder.md

@@ -0,0 +1,47 @@
+# 🚀 The `founder` experience
+
+> Set `profile.id: founder` (wizard, or `agent-config use --profile=founder`).
+> **Preset default: `fast`.**
+
+## Who it's for
+
+The solo / early-stage founder — sharpen a fuzzy idea, rank what to build, write
+the why-now slide, get a neutral second opinion.
+
+## First three tasks
+
+1. **Sharpen the idea** — `/challenge-me` runs a grill-style interview that turns a vague plan into a copyable pitch.
+2. **Rank the backlog** — `rice-prioritization` orders what to build next.
+3. **Get a second opinion** — `/council` polls external AIs for a neutral read on a plan or decision.
+
+## First commands
+
+`/work` · `/feature` · `/challenge-me` · `/council`
+
+## Packs that activate
+
+`founder-strategy` + `product-basic` + `finance-basic` (+ `meta`, always on).
+
+## Flows that apply
+
+[Discovery](../flows.md) is the home flow — idea → plan → estimate → refine.
+Implementation applies when the founder builds; review/delivery are light until
+there is a team. Strategy/finance work is pack-skill-driven.
+
+## What is NOT loaded
+
+No `engineering-base` by default (added per session if the founder codes), no
+`ai-video`, no `gtm-marketing`, no `finance-advanced`. Lean, fast-preset surface.
+
+## Example
+
+> *"Should we build the team-seats feature next?"* → `/challenge-me` interviews
+> to 95% confidence and emits a copyable pitch; `rice-prioritization` ranks it
+> against the backlog; `vision-articulation` frames the why-now.
+
+## See also
+
+[Profile (deep)](../profiles.md#profile-founder) ·
+[Role guide](../getting-started-by-role.md#founder-early-stage-operator-wearing-every-hat) ·
+[Flows](../flows.md) ·
+key skills: `rice-prioritization` · `vision-articulation` · `fundraising-narrative` · `runway-cognition`.

package/docs/experiences/ops.md

@@ -0,0 +1,47 @@
+# 🛡 The `ops` experience
+
+> Set `profile.id: ops` (wizard, or `agent-config use --profile=ops`).
+> **Preset default: `strict`.**
+
+## Who it's for
+
+RevOps, support, SRE-adjacent — threat-model a change before it ships, command
+the incident when it breaks, build the dashboard that catches it next time.
+
+## First three tasks
+
+1. **Threat-model first** — `/threat-model` enumerates abuse cases and trust boundaries before the first line of code.
+2. **Command the incident** — `incident-commander` frames severity and the post-mortem.
+3. **Build the signal** — `dashboard-design` chooses the right RED / USE / Golden-Signal panel.
+
+## First commands
+
+`/work` · `/threat-model` · `/review-changes` · `/fix`
+
+## Packs that activate
+
+`engineering-base` + `founder-strategy` (+ `meta`, always on).
+
+## Flows that apply
+
+[Implementation](../flows.md), **review** (threat-model is the front door), and
+**delivery** apply; discovery is lighter. The `strict` preset keeps the
+security/quality gates tight.
+
+## What is NOT loaded
+
+No `ai-video`, no `gtm-marketing`, no `finance-*`. Engineering + reliability
+surface, not a studio or CFO one.
+
+## Example
+
+> *"We're adding a public webhook endpoint."* → `/threat-model` enumerates abuse
+> cases + trust boundaries first (per `security-sensitive-stop`); `/review-changes`
+> dispatches the security judge; `logging-monitoring` keeps PII out of the stream.
+
+## See also
+
+[Profile (deep)](../profiles.md#profile-ops) ·
+[Role guide](../getting-started-by-role.md#finance--ops-cfo-controller-ops-lead-founder-finance) ·
+[Flows](../flows.md) ·
+key skills: `incident-commander` · `dashboard-design` · `logging-monitoring` · `threat-modeling` · `launch-readiness`.

package/docs/featured-commands.md

@@ -1,27 +1,27 @@
 # Featured Commands
 
 A curated subset of the 124 active commands. Full set lives in
-[`.agent-src/commands/`](../.agent-src/commands/) — see also
+[`dist/agent-src/commands/`](../dist/agent-src/commands/) — see also
 [`docs/catalog.md`](catalog.md) for the complete index.
 
 ## For developers
 
 | Command | What it does |
 |---|---|
-| [`/implement-ticket`](../.agent-src/commands/implement-ticket.md) | Drive a Jira / Linear ticket end-to-end through refine → plan → implement → test → verify |
-| [`/work`](../.agent-src/commands/work.md) | Same end-to-end loop for a free-form prompt — confidence-band gated |
-| [`/fix ci`](../.agent-src/commands/fix.md) | Fetch CI failures from GitHub Actions and fix them |
-| [`/review-changes`](../.agent-src/commands/review-changes.md) | Self-review local changes before creating a PR (five judges) |
-| [`/create-pr`](../.agent-src/commands/create-pr.md) | Create a GitHub PR with Jira-linked description |
+| [`/implement-ticket`](../dist/agent-src/commands/implement-ticket.md) | Drive a Jira / Linear ticket end-to-end through refine → plan → implement → test → verify |
+| [`/work`](../dist/agent-src/commands/work.md) | Same end-to-end loop for a free-form prompt — confidence-band gated |
+| [`/fix ci`](../dist/agent-src/commands/fix.md) | Fetch CI failures from GitHub Actions and fix them |
+| [`/review-changes`](../dist/agent-src/commands/review-changes.md) | Self-review local changes before creating a PR (five judges) |
+| [`/create-pr`](../dist/agent-src/commands/create-pr.md) | Create a GitHub PR with Jira-linked description |
 
 ## For everyone
 
 | Command | What it does |
 |---|---|
-| [`/research`](../.agent-src/commands/research.md) | Survey / benchmark / competitive scan scaffolder — picks objects, defines fields |
-| [`po-discovery`](../.agent-src/skills/po-discovery/SKILL.md) | Shape a fuzzy product ask into a refined backlog item — problem framing, AC tightening |
-| [`/ghostwriter:write`](../.agent-src/commands/ghostwriter/write.md) | Draft in a public-figure voice profile (mandatory disclosure footer) |
-| [`/challenge-me`](../.agent-src/commands/challenge-me.md) | Interactive grill-style interview that sharpens a fuzzy plan into a copyable pitch |
-| [`/fundraising-narrative`](../.agent-src/skills/fundraising-narrative/SKILL.md) | Shape a capital-raise pitch — why-now / why-us / why-this framing |
+| [`/research`](../dist/agent-src/commands/research.md) | Survey / benchmark / competitive scan scaffolder — picks objects, defines fields |
+| [`po-discovery`](../dist/agent-src/skills/po-discovery/SKILL.md) | Shape a fuzzy product ask into a refined backlog item — problem framing, AC tightening |
+| [`/ghostwriter:write`](../dist/agent-src/commands/ghostwriter/write.md) | Draft in a public-figure voice profile (mandatory disclosure footer) |
+| [`/challenge-me`](../dist/agent-src/commands/challenge-me.md) | Interactive grill-style interview that sharpens a fuzzy plan into a copyable pitch |
+| [`/fundraising-narrative`](../dist/agent-src/skills/fundraising-narrative/SKILL.md) | Shape a capital-raise pitch — why-now / why-us / why-this framing |
 
-→ [Browse all 124 active commands](../.agent-src/commands/)
+→ [Browse all 124 active commands](../dist/agent-src/commands/)

package/docs/featured-skills.md

@@ -1,10 +1,10 @@
 # Featured Skills
 
-A curated subset of the ~218 active skills. Three tiers, one per primary audience. Full catalog lives in [`.agent-src/skills/`](../.agent-src/skills/); see also [`docs/catalog.md`](catalog.md) for the complete index and [`docs/featured-commands.md`](featured-commands.md) for command-level highlights.
+A curated subset of the ~218 active skills. Three tiers, one per primary audience. Full catalog lives in [`dist/agent-src/skills/`](../dist/agent-src/skills/); see also [`docs/catalog.md`](catalog.md) for the complete index and [`docs/featured-commands.md`](featured-commands.md) for command-level highlights.
 
 > **Eval-gated messaging note.** Until `task bench --corpus non-dev` reports `selection_accuracy >= 0.60` (see `road-to-product-adoption.md` Phase 1), this page is documentation, not marketing. The entries below are the candidates the corpus tests against; their description quality is what the eval validates.
 
-Each row links to the canonical artefact under `.agent-src/`. Substitutions vs. the original roadmap proposal: `pitch-narrative` → [`fundraising-narrative`](../.agent-src/skills/fundraising-narrative/SKILL.md) (closest existing skill; pitch-narrative is not yet authored).
+Each row links to the canonical artefact under `dist/agent-src/`. Substitutions vs. the original roadmap proposal: `pitch-narrative` → [`fundraising-narrative`](../dist/agent-src/skills/fundraising-narrative/SKILL.md) (closest existing skill; pitch-narrative is not yet authored).
 
 ---
 
@@ -17,16 +17,16 @@ Each row links to the canonical artefact under `.agent-src/`. Substitutions vs.
 
 | Artefact | What it does |
 |---|---|
-| [`/refine-prompt`](../.agent-src/skills/refine-prompt/SKILL.md) | Reconstruct a free-form prompt into actionable AC + assumptions + confidence band before the engine plans |
-| [`/work`](../.agent-src/commands/work.md) | Drive a free-form prompt end-to-end through refine → score → plan → implement → test → verify → report |
-| [`/grill-me`](../.agent-src/commands/grill-me.md) | Interactive grill-style interview that sharpens a fuzzy plan / idea into a copyable Markdown pitch |
-| [`/optimize-prompt`](../.agent-src/commands/optimize-prompt.md) | Optimize a raw prompt for ChatGPT / Claude / Gemini via the 4-D methodology |
-| [`decision-record`](../.agent-src/skills/decision-record/SKILL.md) | Lock a trade-off — options · trade-offs · consequences — before the ADR file is written |
-| [`fundraising-narrative`](../.agent-src/skills/fundraising-narrative/SKILL.md) | Why-now / why-us / why-this framing, market-size reasoning, traction-story construction |
-| [`okr-tree-modeling`](../.agent-src/skills/okr-tree-modeling/SKILL.md) | Decompose a company objective into team OKRs; audit a draft tree for measurability and laddering |
-| [`voc-extract`](../.agent-src/skills/voc-extract/SKILL.md) | Extract Voice-of-Customer themes from existing artefacts — GH issues, PR threads, Sentry patterns |
-| [`dcf-modeling`](../.agent-src/skills/dcf-modeling/SKILL.md) | Valuation cognition for a CFO / finance-partner — DCF, WACC, terminal value, sensitivity |
-| [`runway-cognition`](../.agent-src/skills/runway-cognition/SKILL.md) | Cash runway, burn shape, fundraise triggers, layoff-vs-cut-vs-grow decisions |
+| [`/refine-prompt`](../dist/agent-src/skills/refine-prompt/SKILL.md) | Reconstruct a free-form prompt into actionable AC + assumptions + confidence band before the engine plans |
+| [`/work`](../dist/agent-src/commands/work.md) | Drive a free-form prompt end-to-end through refine → score → plan → implement → test → verify → report |
+| [`/grill-me`](../dist/agent-src/commands/grill-me.md) | Interactive grill-style interview that sharpens a fuzzy plan / idea into a copyable Markdown pitch |
+| [`/optimize-prompt`](../dist/agent-src/commands/optimize-prompt.md) | Optimize a raw prompt for ChatGPT / Claude / Gemini via the 4-D methodology |
+| [`decision-record`](../dist/agent-src/skills/decision-record/SKILL.md) | Lock a trade-off — options · trade-offs · consequences — before the ADR file is written |
+| [`fundraising-narrative`](../dist/agent-src/skills/fundraising-narrative/SKILL.md) | Why-now / why-us / why-this framing, market-size reasoning, traction-story construction |
+| [`okr-tree-modeling`](../dist/agent-src/skills/okr-tree-modeling/SKILL.md) | Decompose a company objective into team OKRs; audit a draft tree for measurability and laddering |
+| [`voc-extract`](../dist/agent-src/skills/voc-extract/SKILL.md) | Extract Voice-of-Customer themes from existing artefacts — GH issues, PR threads, Sentry patterns |
+| [`dcf-modeling`](../dist/agent-src/skills/dcf-modeling/SKILL.md) | Valuation cognition for a CFO / finance-partner — DCF, WACC, terminal value, sensitivity |
+| [`runway-cognition`](../dist/agent-src/skills/runway-cognition/SKILL.md) | Cash runway, burn shape, fundraise triggers, layoff-vs-cut-vs-grow decisions |
 
 → Pack details: [`packages/founder-strategy/`](../packages/founder-strategy/) · Role guide: [`docs/getting-started-by-role.md#founder`](getting-started-by-role.md#founder-early-stage-operator-wearing-every-hat)
 
@@ -41,14 +41,14 @@ Each row links to the canonical artefact under `.agent-src/`. Substitutions vs.
 
 | Artefact | What it does |
 |---|---|
-| [`/video:from-script`](../.agent-src/commands/video/from-script.md) | End-to-end pipeline: script → character-locked image → motion + audio prompt → provider render → stitched clip |
-| [`/video:scene`](../.agent-src/commands/video/scene.md) | Render a single scene from an existing blueprint against the configured provider adapter |
-| [`/video:storyboard`](../.agent-src/commands/video/storyboard.md) | Expand a one-line idea into the 12-block Cinematic Scene Blueprint (provider-agnostic) |
-| [`pixar-storyteller`](../.agent-src/skills/pixar-storyteller/SKILL.md) | Turn an idea into a Pixar-style animation prompt — character sheet, scene, image, video — anchored in emotional beat, want, obstacle |
-| [`motion-choreographer`](../.agent-src/skills/motion-choreographer/SKILL.md) | Turn a locked still + blueprint into a provider-tuned motion prompt — camera, primary + secondary motion, physics, native-audio sync |
-| [`canvas-design`](../.agent-src/skills/canvas-design/SKILL.md) | Create static visual art — posters, marketing visuals, brand assets, PDF / PNG design pieces |
-| [`voice-and-tone-design`](../.agent-src/skills/voice-and-tone-design/SKILL.md) | Define and audit brand voice — voice attributes, tone-by-context matrix, consistency review |
-| [`editorial-calendar`](../.agent-src/skills/editorial-calendar/SKILL.md) | Cadence shape — evergreen vs campaign vs reactive, beat-mapping across channel stages, content-debt management |
+| [`/video:from-script`](../dist/agent-src/commands/video/from-script.md) | End-to-end pipeline: script → character-locked image → motion + audio prompt → provider render → stitched clip |
+| [`/video:scene`](../dist/agent-src/commands/video/scene.md) | Render a single scene from an existing blueprint against the configured provider adapter |
+| [`/video:storyboard`](../dist/agent-src/commands/video/storyboard.md) | Expand a one-line idea into the 12-block Cinematic Scene Blueprint (provider-agnostic) |
+| [`pixar-storyteller`](../dist/agent-src/skills/pixar-storyteller/SKILL.md) | Turn an idea into a Pixar-style animation prompt — character sheet, scene, image, video — anchored in emotional beat, want, obstacle |
+| [`motion-choreographer`](../dist/agent-src/skills/motion-choreographer/SKILL.md) | Turn a locked still + blueprint into a provider-tuned motion prompt — camera, primary + secondary motion, physics, native-audio sync |
+| [`canvas-design`](../dist/agent-src/skills/canvas-design/SKILL.md) | Create static visual art — posters, marketing visuals, brand assets, PDF / PNG design pieces |
+| [`voice-and-tone-design`](../dist/agent-src/skills/voice-and-tone-design/SKILL.md) | Define and audit brand voice — voice attributes, tone-by-context matrix, consistency review |
+| [`editorial-calendar`](../dist/agent-src/skills/editorial-calendar/SKILL.md) | Cadence shape — evergreen vs campaign vs reactive, beat-mapping across channel stages, content-debt management |
 
 `AIV_DRYRUN=true` is the mandatory default for video pipelines — no provider call, no spend until you opt in.
 
@@ -65,16 +65,16 @@ Each row links to the canonical artefact under `.agent-src/`. Substitutions vs.
 
 | Artefact | What it does |
 |---|---|
-| [`/work`](../.agent-src/commands/work.md) | Free-form prompt end-to-end loop — refine → plan → implement → test → verify, confidence-band gated |
-| [`/implement-ticket`](../.agent-src/commands/implement-ticket.md) | Drive a Jira / Linear ticket end-to-end — same loop, ticket-anchored |
-| [`/review-changes`](../.agent-src/commands/review-changes.md) | Self-review local changes before creating a PR — dispatches to five specialized judges and consolidates verdicts |
-| [`/commit`](../.agent-src/commands/commit.md) | Stage and commit all uncommitted changes — splits into logical commits following Conventional Commits |
-| [`judge-bug-hunter`](../.agent-src/skills/judge-bug-hunter/SKILL.md) | Correctness review — null-safety, edge cases, off-by-one, races, error handling |
-| [`judge-code-quality`](../.agent-src/skills/judge-code-quality/SKILL.md) | Readability review — naming, single-responsibility, DRY, dead code, codebase-convention drift |
-| [`judge-security-auditor`](../.agent-src/skills/judge-security-auditor/SKILL.md) | Security review — authZ, injection, secrets, unsafe deserialization, SSRF, XSS, mass assignment |
-| [`judge-test-coverage`](../.agent-src/skills/judge-test-coverage/SKILL.md) | Test review — missing assertions, uncovered branches, over-mocking, regression coverage |
-| [`playwright-architect`](../.agent-src/skills/playwright-architect/SKILL.md) | Shape a Playwright suite — locator strategy, Page Object boundaries, fixture composition, flake prevention |
-| [`threat-modeling`](../.agent-src/skills/threat-modeling/SKILL.md) | Pre-implementation threat model — trust boundaries + abuse cases mapped to files, BEFORE the first line of code |
+| [`/work`](../dist/agent-src/commands/work.md) | Free-form prompt end-to-end loop — refine → plan → implement → test → verify, confidence-band gated |
+| [`/implement-ticket`](../dist/agent-src/commands/implement-ticket.md) | Drive a Jira / Linear ticket end-to-end — same loop, ticket-anchored |
+| [`/review-changes`](../dist/agent-src/commands/review-changes.md) | Self-review local changes before creating a PR — dispatches to five specialized judges and consolidates verdicts |
+| [`/commit`](../dist/agent-src/commands/commit.md) | Stage and commit all uncommitted changes — splits into logical commits following Conventional Commits |
+| [`judge-bug-hunter`](../dist/agent-src/skills/judge-bug-hunter/SKILL.md) | Correctness review — null-safety, edge cases, off-by-one, races, error handling |
+| [`judge-code-quality`](../dist/agent-src/skills/judge-code-quality/SKILL.md) | Readability review — naming, single-responsibility, DRY, dead code, codebase-convention drift |
+| [`judge-security-auditor`](../dist/agent-src/skills/judge-security-auditor/SKILL.md) | Security review — authZ, injection, secrets, unsafe deserialization, SSRF, XSS, mass assignment |
+| [`judge-test-coverage`](../dist/agent-src/skills/judge-test-coverage/SKILL.md) | Test review — missing assertions, uncovered branches, over-mocking, regression coverage |
+| [`playwright-architect`](../dist/agent-src/skills/playwright-architect/SKILL.md) | Shape a Playwright suite — locator strategy, Page Object boundaries, fixture composition, flake prevention |
+| [`threat-modeling`](../dist/agent-src/skills/threat-modeling/SKILL.md) | Pre-implementation threat model — trust boundaries + abuse cases mapped to files, BEFORE the first line of code |
 
 → Pack details: [`packages/engineering-base/`](../packages/engineering-base/) · Role guide: [`docs/getting-started-by-role.md#developer`](getting-started-by-role.md#developer-the-original-audience)
 
@@ -90,6 +90,6 @@ task lint-featured-skills
 python3 scripts/lint_featured_skills.py
 ```
 
-CI runs this in `taskfiles/ci-fast.yml`. Stale entries (renamed / removed skill or command) fail the build. See [`scripts/lint_featured_skills.py`](../scripts/lint_featured_skills.py) for the matcher.
+CI runs this in `taskfiles/ci-fast.yml`. Stale entries (renamed / removed skill or command) fail the build. See [`scripts/lint_featured_skills.py`](../src/scripts/lint_featured_skills.py) for the matcher.
 
-→ Browse all ~218 active skills: [`.agent-src/skills/`](../.agent-src/skills/) · all ~129 commands: [`.agent-src/commands/`](../.agent-src/commands/)
+→ Browse all ~218 active skills: [`dist/agent-src/skills/`](../dist/agent-src/skills/) · all ~129 commands: [`dist/agent-src/commands/`](../dist/agent-src/commands/)

package/docs/flows.md

@@ -0,0 +1,67 @@
+# Flows — the user-work journeys
+
+A **Flow** names a multi-command *user-work journey*, the connective tissue
+between the curated command surface and the day-to-day developer journey. It
+answers **"what am I trying to *do*?"** — not "which command do I type?".
+
+The layered model:
+
+```
+Profile → Pack → Flow → Command → Skill → Rule
+```
+
+The user-facing developer story is **discovery → implementation → review →
+delivery**. Each flow below lists its **entry commands** (the daily front
+doors), its **canonical path** (the typical command sequence), and the
+**skills** it composes end-to-end. Source of truth:
+[`src/flows/<flow>.yaml`](../src/flows/) (schema + lint:
+[`flow.schema.json`](../src/scripts/schemas/flow.schema.json),
+[`lint_flows.py`](../src/scripts/lint_flows.py); data-model in
+[`ADR-055`](decisions/ADR-055-flow-layer-data-model.md)).
+
+## 🔍 Discovery — *what should we build, and how*
+
+Explore, plan, estimate, refine, and investigate **before** building.
+
+- **Entry commands:** `/feature:plan` · `/bug-investigate` · `/research`
+- **Canonical path:** `/feature:explore` → `/feature:plan` → `/estimate-ticket` → `/refine-ticket`
+- **Skills:** `feature-planning` · `estimate-ticket` · `refine-ticket` · `project-analysis-core` · `validate-feature-fit`
+
+## 🔨 Implementation — *build it*
+
+Drive a prompt, ticket, or feature end-to-end through plan → implement → verify.
+
+- **Entry commands:** `/work` · `/implement-ticket` · `/feature:dev` · `/bug-fix`
+- **Canonical path:** `/work` → `/review-changes` → `/quality-fix` → `/commit`
+- **Skills:** `test-driven-development` · `code-review` · `systematic-debugging` · `git-workflow`
+
+## 🔎 Review — *check it*
+
+Self-review, judge, quality-fix, and threat-model a change before it ships.
+
+- **Entry commands:** `/review-changes` · `/judge`
+- **Canonical path:** `/review-changes` → `/judge` → `/quality-fix` → `/threat-model`
+- **Skills:** `code-review` · `adversarial-review` · `quality-tools` · `threat-modeling` · `receiving-code-review`
+
+## 🚢 Delivery — *ship it*
+
+Commit in logical chunks, open the PR, answer review comments, prepare the
+branch for review.
+
+- **Entry commands:** `/commit` · `/pr:create` · `/prepare-for-review`
+- **Canonical path:** `/commit` → `/pr:create` → `/fix:pr-comments`
+- **Skills:** `conventional-commits-writing` · `git-workflow` · `requesting-code-review`
+
+## Why `agent-admin` is not a flow
+
+`agent-admin` (memory · analytics · governance · config) describes **system
+administration**, not user *work*. The four flows above describe what a user
+*does*; `agent-admin` describes how the platform is *operated* — almost entirely
+skills plus a couple of state-queries. It stays out of the flow set by
+construction.
+
+## See also
+
+- [`profiles.md`](profiles.md) — the six entry profiles that select which packs (and so which flows) surface.
+- [`catalog.md`](catalog.md) — the full command / skill / rule / guideline surface.
+- [`src/flows/README.md`](../src/flows/README.md) — the flow schema and the source stubs.