gsdd-cli 0.18.4 → 0.19.0

package/agents/README.md

@@ -1,62 +1,62 @@
-# Canonical Role Library
-
-Vendor-agnostic role contracts for Workspine's agent architecture.
-
-## Two-Layer Architecture
-
-| Layer | Location | Purpose |
-|-------|----------|---------|
-| **Roles** (this directory) | `agents/*.md` | Durable contracts: identity, inputs, outputs, algorithm, guarantees |
-| **Delegates** | `distilled/templates/delegates/*.md` | Task-specific wrappers: scoped instructions that reference a role |
-
-Roles define what an agent is. Delegates define what an agent does in a specific workflow context.
-
-## Lifecycle Roles
-
-| Role | File | Absorbs From (GSD) |
-|------|------|---------------------|
-| Mapper | `mapper.md` | `gsd-codebase-mapper.md` |
-| Researcher | `researcher.md` | `gsd-project-researcher.md` + `gsd-phase-researcher.md` |
-| Synthesizer | `synthesizer.md` | `gsd-research-synthesizer.md` |
-| Approach Explorer | `approach-explorer.md` | `discuss-phase.md` + `list-phase-assumptions.md` + `discovery-phase.md` |
-| Planner | `planner.md` | `gsd-planner.md` + `gsd-plan-checker.md` |
-| Executor | `executor.md` | `gsd-executor.md` |
-| Verifier | `verifier.md` | `gsd-verifier.md` |
-| Roadmapper | `roadmapper.md` | `gsd-roadmapper.md` |
-
-## Audit Roles
-
-| Role | File | Absorbs From (GSD) |
-|------|------|--------------------|
-| Integration Checker | `integration-checker.md` | `gsd-integration-checker.md` |
-
-## Utility Roles
-
-| Role | File | Note |
-|------|------|------|
-| Debugger | `debugger.md` | Not part of core lifecycle. Standalone diagnostic utility. |
-
-## Runtime Distribution
-
-`gsdd init` copies all role contracts (excluding this README) from `agents/` into `.planning/templates/roles/` in the consumer project. This gives consumer projects a portable, self-contained copy of the role library with no hard dependency on the GSDD framework repo at runtime.
-
-- **Single source of truth:** `agents/*.md` in this repo. Consumer copies are generated, not edited.
-- **Delegates reference the local copy:** `distilled/templates/delegates/*.md` point to `.planning/templates/roles/<role>.md`, not back to this repo.
-- **Idempotent:** `gsdd init` skips the copy if `.planning/templates/roles/` already exists.
-- **Updates:** `gsdd update --templates` re-copies from latest framework sources with hash-based modification detection.
-
-Verifier note:
-- `verifier.md` is phase-scoped.
-- The milestone integration-audit surface exists as `distilled/workflows/audit-milestone.md` with its own `integration-checker.md` role contract. It is not absorbed into the verifier.
-
-## Commit Convention
-
-All commits — whether authored by humans or AI agents — must follow [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/). The `semantic-release` automation reads commit messages to determine version bumps and generate the changelog. A commit not following the convention produces no release and no changelog entry.
-
-Use `feat:` for new capabilities, `fix:` for corrections, `chore:` for maintenance that must not trigger a publish, and `test:` for test-only changes. Never use `chore(release):` — that prefix is reserved for the release automation.
-
-See `CONTRIBUTING.md` for the full type table.
-
-## Archive
-
-`_archive/` contains the original 11 GSD agent files (preserved via `git mv` for history). These are the verbose, GSD-specific sources from which canonical roles were distilled. Do not reference them in workflows; use the canonical roles above.
+# Canonical Role Library
+
+Vendor-agnostic role contracts for Workspine's agent architecture.
+
+## Two-Layer Architecture
+
+| Layer | Location | Purpose |
+|-------|----------|---------|
+| **Roles** (this directory) | `agents/*.md` | Durable contracts: identity, inputs, outputs, algorithm, guarantees |
+| **Delegates** | `distilled/templates/delegates/*.md` | Task-specific wrappers: scoped instructions that reference a role |
+
+Roles define what an agent is. Delegates define what an agent does in a specific workflow context.
+
+## Lifecycle Roles
+
+| Role | File | Absorbs From (GSD) |
+|------|------|---------------------|
+| Mapper | `mapper.md` | `gsd-codebase-mapper.md` |
+| Researcher | `researcher.md` | `gsd-project-researcher.md` + `gsd-phase-researcher.md` |
+| Synthesizer | `synthesizer.md` | `gsd-research-synthesizer.md` |
+| Approach Explorer | `approach-explorer.md` | `discuss-phase.md` + `list-phase-assumptions.md` + `discovery-phase.md` |
+| Planner | `planner.md` | `gsd-planner.md` + `gsd-plan-checker.md` |
+| Executor | `executor.md` | `gsd-executor.md` |
+| Verifier | `verifier.md` | `gsd-verifier.md` |
+| Roadmapper | `roadmapper.md` | `gsd-roadmapper.md` |
+
+## Audit Roles
+
+| Role | File | Absorbs From (GSD) |
+|------|------|--------------------|
+| Integration Checker | `integration-checker.md` | `gsd-integration-checker.md` |
+
+## Utility Roles
+
+| Role | File | Note |
+|------|------|------|
+| Debugger | `debugger.md` | Not part of core lifecycle. Standalone diagnostic utility. |
+
+## Runtime Distribution
+
+`gsdd init` copies all role contracts (excluding this README) from `agents/` into `.planning/templates/roles/` in the consumer project. This gives consumer projects a portable, self-contained copy of the role library with no hard dependency on the GSDD framework repo at runtime.
+
+- **Single source of truth:** `agents/*.md` in this repo. Consumer copies are generated, not edited.
+- **Delegates reference the local copy:** `distilled/templates/delegates/*.md` point to `.planning/templates/roles/<role>.md`, not back to this repo.
+- **Idempotent:** `gsdd init` skips the copy if `.planning/templates/roles/` already exists.
+- **Updates:** `gsdd update --templates` re-copies from latest framework sources with hash-based modification detection.
+
+Verifier note:
+- `verifier.md` is phase-scoped.
+- The milestone integration-audit surface exists as `distilled/workflows/audit-milestone.md` with its own `integration-checker.md` role contract. It is not absorbed into the verifier.
+
+## Commit Convention
+
+All commits — whether authored by humans or AI agents — must follow [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/). The `semantic-release` automation reads commit messages to determine version bumps and generate the changelog. A commit not following the convention produces no release and no changelog entry.
+
+Use `feat:` for new capabilities, `fix:` for corrections, `chore:` for maintenance that must not trigger a publish, and `test:` for test-only changes. Never use `chore(release):` — that prefix is reserved for the release automation.
+
+See `CONTRIBUTING.md` for the full type table.
+
+## Archive
+
+`_archive/` contains the original 11 GSD agent files (preserved via `git mv` for history). These are the verbose, GSD-specific sources from which canonical roles were distilled. Do not reference them in workflows; use the canonical roles above.