Skip to content

stark-ai-de/agent-skills / plugins/stark-ai-developer/skills/architecture-compass

architecture-compass

Verified

Set up ADR governance, audit architecture and drift, or plan and execute bounded refactors and code simplification. Use when work needs binding architecture decisions, library reuse, shared-code ownership, provider-to-local mapping, or architecture PR review.

FileKindSize
SKILL.mdskill md16.1 KB
agents/openai.yamlconfig692 B
assets/adr-example.guide.mdmarkdown1.5 KB
assets/adr-example.long.mdmarkdown2.3 KB
assets/adr-example.short.mdmarkdown1.1 KB
assets/adr-index-template.mdmarkdown1.3 KB
assets/adr-template.guide.mdmarkdown1.2 KB
assets/adr-template.long.mdmarkdown1.3 KB
assets/adr-template.short.mdmarkdown1.1 KB
assets/agent-instructions-template.mdmarkdown5.9 KB
assets/module-contract-review.mdmarkdown2.1 KB
assets/new-repo-adoption-plan-template.mdmarkdown6.7 KB
assets/openai-icon.pngbinary62.8 KB
assets/product-planning-profile.mdmarkdown3.7 KB
assets/product-planning-work-item.mdmarkdown2.6 KB
assets/refactor-report-template.mdmarkdown12.2 KB
assets/setup-report-template.mdmarkdown15.0 KB
assets/testing-outcome-receipt-template.mdmarkdown6.0 KB
assets/vitest4-testing-profile.mdmarkdown9.0 KB
references/ac-adr-001-route-architecture-compass-through-canonical-adr-triplets.guide.mdmarkdown3.7 KB
references/ac-adr-001-route-architecture-compass-through-canonical-adr-triplets.long.mdmarkdown4.8 KB
references/ac-adr-001-route-architecture-compass-through-canonical-adr-triplets.short.mdmarkdown1.8 KB
references/ac-adr-002-select-actions-resolve-authority-and-record-guardrail-adoption.guide.mdmarkdown4.0 KB
references/ac-adr-002-select-actions-resolve-authority-and-record-guardrail-adoption.long.mdmarkdown6.4 KB
references/ac-adr-002-select-actions-resolve-authority-and-record-guardrail-adoption.short.mdmarkdown2.0 KB
references/ac-adr-003-coordinate-agents-and-execute-only-approved-bounded-slices.guide.mdmarkdown8.5 KB
references/ac-adr-003-coordinate-agents-and-execute-only-approved-bounded-slices.long.mdmarkdown6.4 KB
references/ac-adr-003-coordinate-agents-and-execute-only-approved-bounded-slices.short.mdmarkdown1.9 KB
references/ac-adr-004-report-staged-evidence-and-protect-public-outputs.guide.mdmarkdown6.3 KB
references/ac-adr-004-report-staged-evidence-and-protect-public-outputs.long.mdmarkdown5.9 KB
references/ac-adr-004-report-staged-evidence-and-protect-public-outputs.short.mdmarkdown1.8 KB
references/ac-adr-005-make-repository-adrs-binding-agent-guardrails.guide.mdmarkdown5.1 KB
references/ac-adr-005-make-repository-adrs-binding-agent-guardrails.long.mdmarkdown5.5 KB
references/ac-adr-005-make-repository-adrs-binding-agent-guardrails.short.mdmarkdown1.6 KB
references/ac-adr-006-assign-workspace-ownership-and-source-roles.guide.mdmarkdown17.7 KB
references/ac-adr-006-assign-workspace-ownership-and-source-roles.long.mdmarkdown5.7 KB
references/ac-adr-006-assign-workspace-ownership-and-source-roles.short.mdmarkdown1.7 KB
references/ac-adr-007-enforce-runtime-safe-module-and-public-package-boundaries.guide.mdmarkdown4.3 KB
references/ac-adr-007-enforce-runtime-safe-module-and-public-package-boundaries.long.mdmarkdown5.7 KB
references/ac-adr-007-enforce-runtime-safe-module-and-public-package-boundaries.short.mdmarkdown1.8 KB
references/ac-adr-008-compose-nextjs-routes-rendering-and-component-responsibilities.guide.mdmarkdown6.5 KB
references/ac-adr-008-compose-nextjs-routes-rendering-and-component-responsibilities.long.mdmarkdown6.6 KB
references/ac-adr-008-compose-nextjs-routes-rendering-and-component-responsibilities.short.mdmarkdown1.8 KB
references/ac-adr-009-choose-read-query-caching-and-freshness-boundaries.guide.mdmarkdown14.1 KB
references/ac-adr-009-choose-read-query-caching-and-freshness-boundaries.long.mdmarkdown5.3 KB
references/ac-adr-009-choose-read-query-caching-and-freshness-boundaries.short.mdmarkdown2.5 KB
references/ac-adr-010-protect-writes-behind-validated-command-boundaries.guide.mdmarkdown6.2 KB
references/ac-adr-010-protect-writes-behind-validated-command-boundaries.long.mdmarkdown4.6 KB
references/ac-adr-010-protect-writes-behind-validated-command-boundaries.short.mdmarkdown2.6 KB
references/ac-adr-011-compose-long-running-backend-runtimes-and-lifecycles-explicitly.guide.mdmarkdown27.4 KB
references/ac-adr-011-compose-long-running-backend-runtimes-and-lifecycles-explicitly.long.mdmarkdown5.0 KB
references/ac-adr-011-compose-long-running-backend-runtimes-and-lifecycles-explicitly.short.mdmarkdown2.7 KB
references/ac-adr-012-resolve-environment-and-configuration-at-deployable-boundaries.guide.mdmarkdown4.6 KB
references/ac-adr-012-resolve-environment-and-configuration-at-deployable-boundaries.long.mdmarkdown4.8 KB
references/ac-adr-012-resolve-environment-and-configuration-at-deployable-boundaries.short.mdmarkdown2.2 KB
references/ac-adr-013-own-language-package-build-lint-and-supply-chain-tooling-explicitly.guide.mdmarkdown6.7 KB
references/ac-adr-013-own-language-package-build-lint-and-supply-chain-tooling-explicitly.long.mdmarkdown5.9 KB
references/ac-adr-013-own-language-package-build-lint-and-supply-chain-tooling-explicitly.short.mdmarkdown2.3 KB
references/ac-adr-014-select-application-runtimes-deployment-hosts-and-additional-targets-by-evidence.guide.mdmarkdown6.3 KB
references/ac-adr-014-select-application-runtimes-deployment-hosts-and-additional-targets-by-evidence.long.mdmarkdown5.4 KB
references/ac-adr-014-select-application-runtimes-deployment-hosts-and-additional-targets-by-evidence.short.mdmarkdown2.1 KB
references/ac-adr-015-select-frontend-capability-libraries-by-product-need.guide.mdmarkdown4.6 KB
references/ac-adr-015-select-frontend-capability-libraries-by-product-need.long.mdmarkdown5.5 KB
references/ac-adr-015-select-frontend-capability-libraries-by-product-need.short.mdmarkdown2.7 KB
references/ac-adr-016-select-ai-model-streaming-ui-and-agent-capabilities-deliberately.guide.mdmarkdown4.9 KB
references/ac-adr-016-select-ai-model-streaming-ui-and-agent-capabilities-deliberately.long.mdmarkdown6.0 KB
references/ac-adr-016-select-ai-model-streaming-ui-and-agent-capabilities-deliberately.short.mdmarkdown2.7 KB
references/ac-adr-017-select-relational-cache-queue-and-realtime-capabilities-by-data-requirements.guide.mdmarkdown6.7 KB
references/ac-adr-017-select-relational-cache-queue-and-realtime-capabilities-by-data-requirements.long.mdmarkdown5.6 KB
references/ac-adr-017-select-relational-cache-queue-and-realtime-capabilities-by-data-requirements.short.mdmarkdown2.8 KB
references/ac-adr-018-validate-behavior-at-the-owning-boundary-and-promote-enforcement-gradually.guide.mdmarkdown3.5 KB
references/ac-adr-018-validate-behavior-at-the-owning-boundary-and-promote-enforcement-gradually.long.mdmarkdown5.9 KB
references/ac-adr-018-validate-behavior-at-the-owning-boundary-and-promote-enforcement-gradually.short.mdmarkdown2.1 KB
references/ac-adr-019-apply-security-and-privacy-controls-at-every-trust-boundary.guide.mdmarkdown3.5 KB
references/ac-adr-019-apply-security-and-privacy-controls-at-every-trust-boundary.long.mdmarkdown6.1 KB
references/ac-adr-019-apply-security-and-privacy-controls-at-every-trust-boundary.short.mdmarkdown2.0 KB
references/ac-adr-020-define-data-ownership-tenancy-retention-and-deletion-before-access-paths.guide.mdmarkdown3.7 KB
references/ac-adr-020-define-data-ownership-tenancy-retention-and-deletion-before-access-paths.long.mdmarkdown5.0 KB
references/ac-adr-020-define-data-ownership-tenancy-retention-and-deletion-before-access-paths.short.mdmarkdown1.9 KB
references/ac-adr-021-preserve-compatibility-through-explicit-migrations-and-deprecation-windows.guide.mdmarkdown3.8 KB
references/ac-adr-021-preserve-compatibility-through-explicit-migrations-and-deprecation-windows.long.mdmarkdown5.6 KB
references/ac-adr-021-preserve-compatibility-through-explicit-migrations-and-deprecation-windows.short.mdmarkdown2.0 KB
references/ac-adr-022-deliver-reversible-slices-with-explicit-rollback-and-promotion-gates.guide.mdmarkdown3.4 KB
references/ac-adr-022-deliver-reversible-slices-with-explicit-rollback-and-promotion-gates.long.mdmarkdown5.0 KB
references/ac-adr-022-deliver-reversible-slices-with-explicit-rollback-and-promotion-gates.short.mdmarkdown1.9 KB
references/ac-adr-023-operate-services-with-observable-health-readiness-failure-and-cleanup.guide.mdmarkdown3.4 KB
references/ac-adr-023-operate-services-with-observable-health-readiness-failure-and-cleanup.long.mdmarkdown5.7 KB
references/ac-adr-023-operate-services-with-observable-health-readiness-failure-and-cleanup.short.mdmarkdown1.9 KB
references/ac-adr-024-meet-an-explicit-accessibility-baseline-with-automated-and-manual-proof.guide.mdmarkdown3.7 KB
references/ac-adr-024-meet-an-explicit-accessibility-baseline-with-automated-and-manual-proof.long.mdmarkdown5.7 KB
references/ac-adr-024-meet-an-explicit-accessibility-baseline-with-automated-and-manual-proof.short.mdmarkdown2.0 KB
references/ac-adr-025-set-measurable-performance-budgets-and-optimize-from-evidence.guide.mdmarkdown3.4 KB
references/ac-adr-025-set-measurable-performance-budgets-and-optimize-from-evidence.long.mdmarkdown5.7 KB
references/ac-adr-025-set-measurable-performance-budgets-and-optimize-from-evidence.short.mdmarkdown2.0 KB
references/ac-adr-026-route-architecture-compass-through-explicit-setup-and-apply-pipelines.guide.mdmarkdown6.0 KB
references/ac-adr-026-route-architecture-compass-through-explicit-setup-and-apply-pipelines.long.mdmarkdown10.0 KB
references/ac-adr-026-route-architecture-compass-through-explicit-setup-and-apply-pipelines.short.mdmarkdown2.5 KB
references/ac-adr-027-use-the-open-agent-skills-specification.guide.mdmarkdown2.0 KB
references/ac-adr-027-use-the-open-agent-skills-specification.long.mdmarkdown3.2 KB
references/ac-adr-027-use-the-open-agent-skills-specification.short.mdmarkdown1.6 KB
references/ac-adr-028-keep-candidates-outside-the-promoted-public-catalog.guide.mdmarkdown2.6 KB
references/ac-adr-028-keep-candidates-outside-the-promoted-public-catalog.long.mdmarkdown3.2 KB
references/ac-adr-028-keep-candidates-outside-the-promoted-public-catalog.short.mdmarkdown1.6 KB
references/ac-adr-029-promote-skills-through-an-evidence-and-maintenance-gate.guide.mdmarkdown2.4 KB
references/ac-adr-029-promote-skills-through-an-evidence-and-maintenance-gate.long.mdmarkdown3.5 KB
references/ac-adr-029-promote-skills-through-an-evidence-and-maintenance-gate.short.mdmarkdown1.6 KB
references/ac-adr-030-license-public-skill-repositories-under-apache-2-0.guide.mdmarkdown2.2 KB
references/ac-adr-030-license-public-skill-repositories-under-apache-2-0.long.mdmarkdown3.5 KB
references/ac-adr-030-license-public-skill-repositories-under-apache-2-0.short.mdmarkdown1.8 KB
references/ac-adr-031-keep-skill-evaluation-evidence-outside-the-runtime-payload.guide.mdmarkdown2.1 KB
references/ac-adr-031-keep-skill-evaluation-evidence-outside-the-runtime-payload.long.mdmarkdown3.6 KB
references/ac-adr-031-keep-skill-evaluation-evidence-outside-the-runtime-payload.short.mdmarkdown1.8 KB
references/ac-adr-032-keep-maintainer-local-helper-state-out-of-public-repositories.guide.mdmarkdown2.3 KB
references/ac-adr-032-keep-maintainer-local-helper-state-out-of-public-repositories.long.mdmarkdown3.7 KB
references/ac-adr-032-keep-maintainer-local-helper-state-out-of-public-repositories.short.mdmarkdown1.9 KB
references/ac-adr-033-choose-portable-dependency-light-skill-helpers.guide.mdmarkdown2.6 KB
references/ac-adr-033-choose-portable-dependency-light-skill-helpers.long.mdmarkdown3.9 KB
references/ac-adr-033-choose-portable-dependency-light-skill-helpers.short.mdmarkdown1.8 KB
references/ac-adr-034-keep-release-metadata-coherent-with-public-catalog-changes.guide.mdmarkdown2.3 KB
references/ac-adr-034-keep-release-metadata-coherent-with-public-catalog-changes.long.mdmarkdown3.8 KB
references/ac-adr-034-keep-release-metadata-coherent-with-public-catalog-changes.short.mdmarkdown1.8 KB
references/ac-adr-035-classify-skill-portability-before-choosing-host-variants.guide.mdmarkdown2.9 KB
references/ac-adr-035-classify-skill-portability-before-choosing-host-variants.long.mdmarkdown4.6 KB
references/ac-adr-035-classify-skill-portability-before-choosing-host-variants.short.mdmarkdown1.9 KB
references/ac-adr-036-keep-architecture-compass-portable-through-host-adapters.guide.mdmarkdown19.3 KB
references/ac-adr-036-keep-architecture-compass-portable-through-host-adapters.long.mdmarkdown4.2 KB
references/ac-adr-036-keep-architecture-compass-portable-through-host-adapters.short.mdmarkdown1.9 KB
references/ac-adr-037-preserve-target-contracts-and-gate-gateway-extraction.guide.mdmarkdown2.8 KB
references/ac-adr-037-preserve-target-contracts-and-gate-gateway-extraction.long.mdmarkdown4.3 KB
references/ac-adr-037-preserve-target-contracts-and-gate-gateway-extraction.short.mdmarkdown1.8 KB
references/ac-adr-038-gate-optional-capabilities-and-tool-side-effects.guide.mdmarkdown2.3 KB
references/ac-adr-038-gate-optional-capabilities-and-tool-side-effects.long.mdmarkdown4.0 KB
references/ac-adr-038-gate-optional-capabilities-and-tool-side-effects.short.mdmarkdown1.8 KB
references/ac-adr-039-prefer-existing-public-skills-conditionally.guide.mdmarkdown2.4 KB
references/ac-adr-039-prefer-existing-public-skills-conditionally.long.mdmarkdown4.3 KB
references/ac-adr-039-prefer-existing-public-skills-conditionally.short.mdmarkdown1.8 KB
references/ac-adr-040-offer-an-opinionated-stack-profile-for-new-public-skill-repositories.guide.mdmarkdown5.4 KB
references/ac-adr-040-offer-an-opinionated-stack-profile-for-new-public-skill-repositories.long.mdmarkdown5.5 KB
references/ac-adr-040-offer-an-opinionated-stack-profile-for-new-public-skill-repositories.short.mdmarkdown2.1 KB
references/ac-adr-041-publish-public-skills-through-github-and-the-open-skills-cli.guide.mdmarkdown2.7 KB
references/ac-adr-041-publish-public-skills-through-github-and-the-open-skills-cli.long.mdmarkdown4.2 KB
references/ac-adr-041-publish-public-skills-through-github-and-the-open-skills-cli.short.mdmarkdown1.9 KB
references/ac-adr-042-calibrate-validation-to-change-risk-and-reuse-fresh-evidence.guide.mdmarkdown7.9 KB
references/ac-adr-042-calibrate-validation-to-change-risk-and-reuse-fresh-evidence.long.mdmarkdown13.9 KB
references/ac-adr-042-calibrate-validation-to-change-risk-and-reuse-fresh-evidence.short.mdmarkdown3.2 KB
references/ac-adr-043-route-architecture-compass-through-explicit-setup-and-apply-pipelines-with-risk-based-validation.guide.mdmarkdown6.1 KB
references/ac-adr-043-route-architecture-compass-through-explicit-setup-and-apply-pipelines-with-risk-based-validation.long.mdmarkdown12.2 KB
references/ac-adr-043-route-architecture-compass-through-explicit-setup-and-apply-pipelines-with-risk-based-validation.short.mdmarkdown3.0 KB
references/ac-adr-044-record-material-decision-lineage-in-non-normative-guides.guide.mdmarkdown3.6 KB
references/ac-adr-044-record-material-decision-lineage-in-non-normative-guides.long.mdmarkdown6.3 KB
references/ac-adr-044-record-material-decision-lineage-in-non-normative-guides.short.mdmarkdown2.4 KB
references/ac-adr-045-route-architecture-compass-through-setup-audit-and-refactor-with-intent-bound-agent-selection.guide.mdmarkdown10.5 KB
references/ac-adr-045-route-architecture-compass-through-setup-audit-and-refactor-with-intent-bound-agent-selection.long.mdmarkdown6.4 KB
references/ac-adr-045-route-architecture-compass-through-setup-audit-and-refactor-with-intent-bound-agent-selection.short.mdmarkdown3.1 KB
references/ac-adr-046-rank-architecture-evidence-without-expanding-operational-authority.guide.mdmarkdown3.4 KB
references/ac-adr-046-rank-architecture-evidence-without-expanding-operational-authority.long.mdmarkdown5.8 KB
references/ac-adr-046-rank-architecture-evidence-without-expanding-operational-authority.short.mdmarkdown2.0 KB
references/ac-adr-047-separate-low-and-moderate-validation-risk-with-explicit-triggers.guide.mdmarkdown7.8 KB
references/ac-adr-047-separate-low-and-moderate-validation-risk-with-explicit-triggers.long.mdmarkdown13.7 KB
references/ac-adr-047-separate-low-and-moderate-validation-risk-with-explicit-triggers.short.mdmarkdown3.4 KB
references/ac-adr-048-persist-approved-governance-before-planned-architecture-refactors.guide.mdmarkdown10.6 KB
references/ac-adr-048-persist-approved-governance-before-planned-architecture-refactors.long.mdmarkdown8.7 KB
references/ac-adr-048-persist-approved-governance-before-planned-architecture-refactors.short.mdmarkdown3.1 KB
references/ac-adr-049-distinguish-change-risk-from-representative-environment-observation.guide.mdmarkdown9.9 KB
references/ac-adr-049-distinguish-change-risk-from-representative-environment-observation.long.mdmarkdown16.3 KB
references/ac-adr-049-distinguish-change-risk-from-representative-environment-observation.short.mdmarkdown4.1 KB
references/ac-adr-050-use-semantic-status-markers-in-user-facing-receipts.guide.mdmarkdown3.3 KB
references/ac-adr-050-use-semantic-status-markers-in-user-facing-receipts.long.mdmarkdown4.8 KB
references/ac-adr-050-use-semantic-status-markers-in-user-facing-receipts.short.mdmarkdown1.8 KB
references/ac-adr-051-route-architecture-compass-through-public-and-internal-decision-namespaces.guide.mdmarkdown3.9 KB
references/ac-adr-051-route-architecture-compass-through-public-and-internal-decision-namespaces.long.mdmarkdown7.4 KB
references/ac-adr-051-route-architecture-compass-through-public-and-internal-decision-namespaces.short.mdmarkdown2.3 KB
references/ac-adr-052-persist-agent-governance-through-host-neutral-repository-surfaces.guide.mdmarkdown4.4 KB
references/ac-adr-052-persist-agent-governance-through-host-neutral-repository-surfaces.long.mdmarkdown7.0 KB
references/ac-adr-052-persist-agent-governance-through-host-neutral-repository-surfaces.short.mdmarkdown2.1 KB
references/ac-adr-053-use-capability-aware-presentation-profiles-for-portable-agent-receipts.guide.mdmarkdown5.0 KB
references/ac-adr-053-use-capability-aware-presentation-profiles-for-portable-agent-receipts.long.mdmarkdown8.5 KB
references/ac-adr-053-use-capability-aware-presentation-profiles-for-portable-agent-receipts.short.mdmarkdown2.2 KB
references/ac-adr-054-isolate-agent-writes-in-external-git-worktrees.guide.mdmarkdown11.5 KB
references/ac-adr-054-isolate-agent-writes-in-external-git-worktrees.long.mdmarkdown7.0 KB
references/ac-adr-054-isolate-agent-writes-in-external-git-worktrees.short.mdmarkdown3.5 KB
references/ac-adr-055-separate-change-impact-from-generated-release-publication.guide.mdmarkdown4.3 KB
references/ac-adr-055-separate-change-impact-from-generated-release-publication.long.mdmarkdown5.4 KB
references/ac-adr-055-separate-change-impact-from-generated-release-publication.short.mdmarkdown2.3 KB
references/ac-adr-056-preserve-release-candidates-through-verified-protected-history.guide.mdmarkdown2.4 KB
references/ac-adr-056-preserve-release-candidates-through-verified-protected-history.long.mdmarkdown3.2 KB
references/ac-adr-056-preserve-release-candidates-through-verified-protected-history.short.mdmarkdown1.8 KB
references/ac-adr-057-separate-metadata-repair-from-installable-artifact-provenance.guide.mdmarkdown2.7 KB
references/ac-adr-057-separate-metadata-repair-from-installable-artifact-provenance.long.mdmarkdown3.6 KB
references/ac-adr-057-separate-metadata-repair-from-installable-artifact-provenance.short.mdmarkdown1.9 KB
references/ac-adr-058-use-pnpm-for-package-management-and-bun-for-execution.guide.mdmarkdown7.1 KB
references/ac-adr-058-use-pnpm-for-package-management-and-bun-for-execution.long.mdmarkdown8.0 KB
references/ac-adr-058-use-pnpm-for-package-management-and-bun-for-execution.short.mdmarkdown3.4 KB
references/ac-adr-059-own-repository-validation-through-discoverable-framework-tests.guide.mdmarkdown2.8 KB
references/ac-adr-059-own-repository-validation-through-discoverable-framework-tests.long.mdmarkdown5.3 KB
references/ac-adr-059-own-repository-validation-through-discoverable-framework-tests.short.mdmarkdown1.8 KB
references/ac-adr-060-isolate-test-execution-by-effects-and-runtime-contracts.guide.mdmarkdown2.4 KB
references/ac-adr-060-isolate-test-execution-by-effects-and-runtime-contracts.long.mdmarkdown5.2 KB
references/ac-adr-060-isolate-test-execution-by-effects-and-runtime-contracts.short.mdmarkdown1.6 KB
references/ac-adr-061-shard-tests-as-complete-fail-closed-evidence-sets.guide.mdmarkdown2.7 KB

assets/new-repo-adoption-plan-template.md

View on GitHub
# New Repository Architecture Adoption Plan

> Derived, non-normative asset. The applicable canonical Long ADRs prevail if this template conflicts or drifts.

Use this after `setup` establishes repository-native governance. It does not extend setup authority into source implementation.

## Setup handoff

- Setup coverage: `recommended | complete`
- Repository evidence state: `new | evidence-empty`
- Foundation candidates evaluated: `AC-ADR-005, AC-ADR-006, AC-ADR-018, AC-ADR-019, AC-ADR-021, AC-ADR-022, AC-ADR-049`
- Provider-to-local mapping path:
- Accepted local decisions and unresolved decisions:
- Protected paths and pre-existing state:
- Setup validation receipt:

## Candidate Dispositions

Do not treat the new-repository foundation as automatic adoption. Preserve each Setup disposition and implement only accepted local decisions.

Use one of `adopt`, `adapt`, `defer`, or `reject` in the Disposition column.

| Provider candidate | Disposition | Local ADR/path | Evidence or adaptation | Deferred trigger/owner or rejection rationale |
| ------------------ | ----------- | -------------- | ---------------------- | --------------------------------------------- |
| AC-ADR-005         |             |                |                        |                                               |
| AC-ADR-006         |             |                |                        |                                               |
| AC-ADR-018         |             |                |                        |                                               |
| AC-ADR-019         |             |                |                        |                                               |
| AC-ADR-021         |             |                |                        |                                               |
| AC-ADR-022         |             |                |                        |                                               |
| AC-ADR-049         |             |                |                        |                                               |

Additional candidates selected by repository evidence:

| Provider candidate | Disposition | Local ADR/path | Selection evidence | Trigger/owner or rejection rationale |
| ------------------ | ----------- | -------------- | ------------------ | ------------------------------------ |
|                    |             |                |                    |                                      |

## First implementation workflow

- Public workflows exposed: `setup | audit | refactor | plan-refactor | plan-run-refactor`
- Recommended route: `plan-run-refactor`
- Selected route: `plan-refactor | plan-run-refactor | refactor`
- Selection rationale and user-authorized outcome/scope:
- Planning capability and transition evidence:
- Expected specification and implementation artifacts:
- Separate destructive, paid, external, deployment, publication, or production approvals:

Use `refactor` only when accepted local ADRs already govern every durable choice and the requested implementation is explicitly bounded. Otherwise use a Plan workflow.

## Repository contract

- ADR directory, index, and successor convention:
- Agent instruction surfaces:
- Validation receipt location:
- Package/module ownership:
- Deployable units and runtime boundaries:
- Public contracts and compatibility policy:
- Security, data, migration, delivery, and rollback obligations:

## Selective Guide / Placement Map

Load only the Guide needed for an accepted candidate and place the resulting rule or implementation at the target repository's owning boundary. A provider Guide is non-normative and does not authorize copying provider paths.

| Accepted local ADR | Provider ADR | Guide path or heading needed | Target owning boundary | Exact target placement | Selection evidence |
| ------------------ | ------------ | ---------------------------- | ---------------------- | ---------------------- | ------------------ |
|                    |              |                              |                        |                        |                    |

## Approved bounded plan

- Outcome and non-goals:
- Exact path allowlist:
- Ordered reversible slices:
- Proof obligations and one owner per obligation:
- Reusable receipts and invalidators:
- Rollback and stop conditions:
- Plan-mode exit requirement:

## Execution preflight

- Repository root, branch, HEAD, and status:
- Accepted ADR and mapping recheck:
- Dependency/toolchain recheck:
- Permissions and protected-path recheck:
- Material drift result:

## Delivery ledger

| Slice | Exact paths | Governing local ADR | Validation | Evidence stage | Environment | Status | Observation/result | Rollback |
| ----- | ----------- | ------------------- | ---------- | -------------- | ----------- | ------ | ------------------ | -------- |
|       |             |                     |            |                |             |        |                    |          |

## AC-ADR-049 validation receipts

Record one receipt per distinct proof obligation. Reconcile delegated receipts against the integrated candidate before the final gate.

```text
Receipt ID:
Risk: low | moderate | high | critical
Cadence: reuse | final-batch | checkpointed | reproduce-first
Proof obligation:
Subject / owning boundary:
Revision / exact candidate artifact / dirty-tree or content fingerprint:
Command / scenario / harness:
Toolchain / config / fixtures / lockfile:
Evidence stage: source/static | local | CI | publication/install | deployed/production | external/third-party
Environment:
Status: verified | failed | not run | unavailable | stale
Observation / result:
Observed at / freshness boundary:
Covered contracts:
Invalidators / limitations:
Owner / source / run link:
Repository-native receipt location:
Skip reason: none | <why this obligation was not executed and who authorized it>
Final aggregate gate: <command or scenario, relationship to this receipt, and result>
```

| Receipt ID | Risk | Cadence | Proof obligation | Subject | Command/scenario/harness | Toolchain | Stage | Environment | Status | Observation/result | Invalidators | Owner | Skip reason | Final aggregate gate relationship |
| ---------- | ---- | ------- | ---------------- | ------- | ------------------------ | --------- | ----- | ----------- | ------ | ------------------ | ------------ | ----- | ----------- | --------------------------------- |
|            |      |         |                  |         |                          |           |       |             |        |                    |              |       |             |                                   |

## Deferred decisions and triggers

| Decision | Why deferred | Owner | Trigger | Blocking scope |
| -------- | ------------ | ----- | ------- | -------------- |
|          |              |       |         |                |
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall