bearings 0.5.3 → 0.5.4

package/templates/agents/commands/setup-repo.md

@@ -1,155 +0,0 @@
----
-description: First-time project tailoring after `bearings init`, and post-update reconciliation when `setupPending`. Not for map refresh.
----
-
-# /setup-repo
-
-Pick one mode and stop when that mode finishes.
-
-- Manifest has `setupPending` → **Post-update reconciliation**, then stop.
-- `AGENTS.md` still has `## Setup Required` → **Required workflow**, then stop.
-- Neither → already done. Map drift is `/refresh-repo-map`.
-
-This is the only operation the temporary `## Setup Required` gate in
-`AGENTS.md` permits. Do not remove the gate until the Required workflow's
-verify step reports zero failures and zero warnings.
-
-Explore the repo before asking. Ask one question at a time, with a
-recommended answer, only for facts the code cannot answer.
-
-## Post-update reconciliation
-
-When `.agents/bearings.json` is manifest v2 and has `setupPending`:
-
-1. Read every file record's ordered `reconciliations` and every top-level
-   `migrationReconciliations` record.
-2. Resolve every `migrationReconciliations` record through **Migrated checklist
-   repairs** below.
-3. For each `skill-update` reconciliation, follow **Starter skill updates**
-   below.
-4. For each remaining reconciliation, read its Backup File and current target, summarize
-   the differences, and ask which backed-up changes to apply to the target.
-5. Apply the developer's choice directly to the target regardless of owner,
-   delete the resolved Backup File, and remove its reconciliation record.
-6. A `skippedTemplate` records a declined template revision.
-   Do not apply the declined template — normal project maintenance may
-   still update that file.
-7. Run `bearings verify`. Resolve every failure and warning except the
-   expected `setup-pending` warning, then remove `setupPending` from the
-   manifest.
-8. Run `bearings verify` again and finish only at zero failures and warnings.
-   Stop here. Do not continue into first-time setup. Do not run `/refresh-repo-map`.
-
-### Starter skill updates (`skill-update`)
-
-For each file record with a `skill-update` reconciliation:
-
-1. Read `basePath`, the live skill path (local), and `incomingPath`. Check
-   whether `basePath` exists before attempting any diff.
-2. If `basePath` is missing, explain that Three-way merge is not available
-   without a historical base. Do not fabricate one. Offer exactly these
-   options (one skill at a time):
-   - **Take new template**, **Keep local**, and **Freeform**. Apply the same
-     manifest and baseline updates described below for the selected outcome.
-3. If `basePath` exists, diff local vs base and incoming vs base; summarize
-   both for the developer. If `basePath` exists, offer exactly these four options
-   (one skill at a time), mark a recommendation:
-   - **Take new template** — replace live skill with incoming; set manifest
-     `hash` and `lastTemplateHash` to incoming hash; `owner: agent`.
-   - **Keep local** — leave live skill; set `hash` to current content hash;
-     keep `lastTemplateHash`; set `skippedTemplate` to the incoming
-     version/hash; `owner: agent`.
-   - **Three-way merge** (Recommended when both diffs are non-empty) — merge
-     both sides into the live skill; then set `hash` to result hash and
-     `lastTemplateHash` to incoming hash; `owner: agent`.
-   - **Freeform** — developer/agent writes the resolved file; same baselining
-     as merge (hash = result, `lastTemplateHash` = incoming hash) unless they
-     explicitly choose to decline the template (then same as Keep local).
-4. Refresh `.agents/.bearings-baseline/skills/<name>/SKILL.md` to match the
-   new content hash.
-5. Delete backup, incoming file, and the reconciliation entry.
-
-### Migrated checklist repairs (`migrationReconciliations`)
-
-Resolve each record through the generic checklist workflow. Invoke the
-`checklist` skill directly, or delegate one record to a subagent that loads and
-follows `.agents/skills/checklist/SKILL.md`.
-
-1. For `testplan-collision`, read the current `target` and the pre-existing
-   checklist in `backup`. Summarize their authored content and ask the developer
-   whether to keep either version or combine them. Write the choice to `target`.
-2. For `invalid-testplan`, read `backup`, explain each contract problem, and
-   repair its useful authored content into `target`. When the record has no
-   `target`, ask the developer to choose a safe
-   `checklists/<category...>/<slug>.json` path first. Do not discard content
-   that cannot be repaired without the developer's decision.
-3. Follow the checklist skill's schema, validation, and full-library build
-   steps for the resolved target. Continue only after validation and build both
-   pass.
-4. Delete the resolved `backup` and remove its
-   `migrationReconciliations` record. Remove the top-level property when no
-   records remain.
-
-## Checklist opener
-
-Reuse an existing equivalent runner command that already invokes
-`npx bearings checklist` (or the repository's established local bearings
-invocation). If none exists, report `npx bearings checklist`. Do not create
-or edit automation files. Do not open the previewer during setup.
-
-## Required workflow
-
-1. Read `AGENTS.md` and `.agents/bearings.json`.
-2. Review every recorded Backup File with the developer: read the backup,
-   summarise what it contained, and ask per file whether to merge into the
-   new scaffold, keep parts, or discard. Apply their choice, then remove
-   the resolved backup.
-3. Fill only the `AGENTS.md` project-purpose and primary-stack placeholders
-   from the repo. Keep `AGENTS.md` a thin router — do not add a skill table,
-   invariants section, or always-on rules block.
-4. Adapt every starter skill:
-   - `.agents/skills/commit-convention/SKILL.md`
-   - `.agents/skills/defer-work/SKILL.md`
-   - `.agents/skills/resurface-deferred-work/SKILL.md`
-   - `.agents/skills/recording-decisions/SKILL.md`
-   - Replace every `<agent: fill during handoff — …>` marker with a real
-     command or explicit `not configured`.
-   - Light project tailoring only — do not remove the skill's safety workflow.
-5. Claim starter skills in `.agents/bearings.json` (allowed manifest edit):
-   - Set each starter skill `owner` to `agent`.
-   - Set `hash` to the sha256 of the file contents (use the same algorithm as
-     bearings: UTF-8 body, `sha256:` + hex).
-   - Set `lastTemplateHash` to the hash of the skill template as shipped in the
-     installed bearings package (read from the package templates if needed;
-     if the adapted file still matches the package template byte-for-byte,
-     `lastTemplateHash` equals `hash`).
-   - Write `.agents/.bearings-baseline/skills/<name>/SKILL.md` equal to the
-     live file bytes.
-6. Complete the **Checklist opener** workflow above.
-7. If `docs/DOMAIN.md`, `docs/ARCHITECTURE.md`, or `docs/CODEBASE_MAP.md`
-   still contains a `<agent:` placeholder, run the `/refresh-repo-map` workflow
-   to initialize those files and `docs/diagrams/c4-component.puml`.
-8. Run `bearings verify`. Fix every failure and every warning. Confirm
-   zero failures and zero warnings. Remove the `## Setup Required` section
-   from `AGENTS.md` — only after that confirmation. Run `bearings verify`
-   again and report the completed setup to the developer.
-
-## Rules
-
-- Do not overwrite developer decisions silently — every merge/keep/discard
-  of a Backup File is the developer's call.
-- Do not edit bearings-owned **commands** except when a recorded Merge
-  reconciliation explicitly permits applying backup changes.
-- Do edit starter **skills** during setup (adapt + claim). After claim they
-  are agent-owned; maintainers may edit them freely.
-- Manifest edits are limited to: skill `owner` / `hash` / `lastTemplateHash` /
-  `skippedTemplate` / `reconciliations`, resolving
-  `migrationReconciliations`, deleting resolved backups/incoming, and clearing
-  `setupPending`.
-- Do not add a skill registry row to `AGENTS.md` — native skill discovery
-  replaces it.
-- Do not invent domain or technical constraints — every stated constraint
-  must come from the developer or from clear evidence in the code (cite
-  the path).
-- Do not remove the `## Setup Required` section before `bearings verify`
-  reports zero failures and zero warnings.