architecture-compass
Set up repository-native ADR governance, audit architecture, or plan and execute ADR-guided refactors through intent-bound workflows. Use when work needs binding agent-facing ADRs, provider-to-local mapping, architecture PR review or drift, Next.js request patterns, source placement, backend/runtime/env/config boundaries, stack deviations, or bounded ADR-governed implementation. Do not use for tiny edits, generic framework education, or work with no architecture or governance consequence.
- Version
- 0.6.8
- License
- Apache-2.0
- Compatibility
- Designed for Codex, Cursor, Claude Code, ChatGPT Chat/Work, Codex web, and other Agent Skills hosts; adapts to host planning, review, question, and permission controls while keeping one portable ADR workflow.
Pinned to revision c1de9ec8f617, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/architecture-compass/SKILL.md
- skills/architecture-compass/agents/openai.yaml
- skills/architecture-compass/assets/adr-example.guide.md
- skills/architecture-compass/assets/adr-example.long.md
- skills/architecture-compass/assets/adr-example.short.md
- skills/architecture-compass/assets/adr-index-template.md
- skills/architecture-compass/assets/adr-template.guide.md
- skills/architecture-compass/assets/adr-template.long.md
- skills/architecture-compass/assets/adr-template.short.md
- skills/architecture-compass/assets/agent-instructions-template.md
- skills/architecture-compass/assets/new-repo-adoption-plan-template.md
- skills/architecture-compass/assets/openai-icon.png
- skills/architecture-compass/assets/refactor-report-template.md
- skills/architecture-compass/assets/setup-report-template.md
- skills/architecture-compass/references/ac-adr-001-route-architecture-compass-through-canonical-adr-triplets.guide.md
- skills/architecture-compass/references/ac-adr-001-route-architecture-compass-through-canonical-adr-triplets.long.md
- skills/architecture-compass/references/ac-adr-001-route-architecture-compass-through-canonical-adr-triplets.short.md
- skills/architecture-compass/references/ac-adr-002-select-actions-resolve-authority-and-record-guardrail-adoption.guide.md
- skills/architecture-compass/references/ac-adr-002-select-actions-resolve-authority-and-record-guardrail-adoption.long.md
- skills/architecture-compass/references/ac-adr-002-select-actions-resolve-authority-and-record-guardrail-adoption.short.md
- skills/architecture-compass/references/ac-adr-003-coordinate-agents-and-execute-only-approved-bounded-slices.guide.md
- skills/architecture-compass/references/ac-adr-003-coordinate-agents-and-execute-only-approved-bounded-slices.long.md
- skills/architecture-compass/references/ac-adr-003-coordinate-agents-and-execute-only-approved-bounded-slices.short.md
- skills/architecture-compass/references/ac-adr-004-report-staged-evidence-and-protect-public-outputs.guide.md
- skills/architecture-compass/references/ac-adr-004-report-staged-evidence-and-protect-public-outputs.long.md
- skills/architecture-compass/references/ac-adr-004-report-staged-evidence-and-protect-public-outputs.short.md
- skills/architecture-compass/references/ac-adr-005-make-repository-adrs-binding-agent-guardrails.guide.md
- skills/architecture-compass/references/ac-adr-005-make-repository-adrs-binding-agent-guardrails.long.md
- skills/architecture-compass/references/ac-adr-005-make-repository-adrs-binding-agent-guardrails.short.md
- skills/architecture-compass/references/ac-adr-006-assign-workspace-ownership-and-source-roles.guide.md
- skills/architecture-compass/references/ac-adr-006-assign-workspace-ownership-and-source-roles.long.md
- skills/architecture-compass/references/ac-adr-006-assign-workspace-ownership-and-source-roles.short.md
- skills/architecture-compass/references/ac-adr-007-enforce-runtime-safe-module-and-public-package-boundaries.guide.md
- skills/architecture-compass/references/ac-adr-007-enforce-runtime-safe-module-and-public-package-boundaries.long.md
- skills/architecture-compass/references/ac-adr-007-enforce-runtime-safe-module-and-public-package-boundaries.short.md
- skills/architecture-compass/references/ac-adr-008-compose-nextjs-routes-rendering-and-component-responsibilities.guide.md
- skills/architecture-compass/references/ac-adr-008-compose-nextjs-routes-rendering-and-component-responsibilities.long.md
- skills/architecture-compass/references/ac-adr-008-compose-nextjs-routes-rendering-and-component-responsibilities.short.md
- skills/architecture-compass/references/ac-adr-009-choose-read-query-caching-and-freshness-boundaries.guide.md
- skills/architecture-compass/references/ac-adr-009-choose-read-query-caching-and-freshness-boundaries.long.md
- skills/architecture-compass/references/ac-adr-009-choose-read-query-caching-and-freshness-boundaries.short.md
- skills/architecture-compass/references/ac-adr-010-protect-writes-behind-validated-command-boundaries.guide.md
- skills/architecture-compass/references/ac-adr-010-protect-writes-behind-validated-command-boundaries.long.md
- skills/architecture-compass/references/ac-adr-010-protect-writes-behind-validated-command-boundaries.short.md
- skills/architecture-compass/references/ac-adr-011-compose-long-running-backend-runtimes-and-lifecycles-explicitly.guide.md
- skills/architecture-compass/references/ac-adr-011-compose-long-running-backend-runtimes-and-lifecycles-explicitly.long.md
- skills/architecture-compass/references/ac-adr-011-compose-long-running-backend-runtimes-and-lifecycles-explicitly.short.md
- skills/architecture-compass/references/ac-adr-012-resolve-environment-and-configuration-at-deployable-boundaries.guide.md
- skills/architecture-compass/references/ac-adr-012-resolve-environment-and-configuration-at-deployable-boundaries.long.md
- skills/architecture-compass/references/ac-adr-012-resolve-environment-and-configuration-at-deployable-boundaries.short.md
- skills/architecture-compass/references/ac-adr-013-own-language-package-build-lint-and-supply-chain-tooling-explicitly.guide.md
- skills/architecture-compass/references/ac-adr-013-own-language-package-build-lint-and-supply-chain-tooling-explicitly.long.md
- skills/architecture-compass/references/ac-adr-013-own-language-package-build-lint-and-supply-chain-tooling-explicitly.short.md
- skills/architecture-compass/references/ac-adr-014-select-application-runtimes-deployment-hosts-and-additional-targets-by-evidence.guide.md
- skills/architecture-compass/references/ac-adr-014-select-application-runtimes-deployment-hosts-and-additional-targets-by-evidence.long.md
- skills/architecture-compass/references/ac-adr-014-select-application-runtimes-deployment-hosts-and-additional-targets-by-evidence.short.md
- skills/architecture-compass/references/ac-adr-015-select-frontend-capability-libraries-by-product-need.guide.md
- skills/architecture-compass/references/ac-adr-015-select-frontend-capability-libraries-by-product-need.long.md
- skills/architecture-compass/references/ac-adr-015-select-frontend-capability-libraries-by-product-need.short.md
- skills/architecture-compass/references/ac-adr-016-select-ai-model-streaming-ui-and-agent-capabilities-deliberately.guide.md
- skills/architecture-compass/references/ac-adr-016-select-ai-model-streaming-ui-and-agent-capabilities-deliberately.long.md
- skills/architecture-compass/references/ac-adr-016-select-ai-model-streaming-ui-and-agent-capabilities-deliberately.short.md
- skills/architecture-compass/references/ac-adr-017-select-relational-cache-queue-and-realtime-capabilities-by-data-requirements.guide.md
- skills/architecture-compass/references/ac-adr-017-select-relational-cache-queue-and-realtime-capabilities-by-data-requirements.long.md
- skills/architecture-compass/references/ac-adr-017-select-relational-cache-queue-and-realtime-capabilities-by-data-requirements.short.md
- skills/architecture-compass/references/ac-adr-018-validate-behavior-at-the-owning-boundary-and-promote-enforcement-gradually.guide.md
- skills/architecture-compass/references/ac-adr-018-validate-behavior-at-the-owning-boundary-and-promote-enforcement-gradually.long.md
- skills/architecture-compass/references/ac-adr-018-validate-behavior-at-the-owning-boundary-and-promote-enforcement-gradually.short.md
- skills/architecture-compass/references/ac-adr-019-apply-security-and-privacy-controls-at-every-trust-boundary.guide.md
- skills/architecture-compass/references/ac-adr-019-apply-security-and-privacy-controls-at-every-trust-boundary.long.md
- skills/architecture-compass/references/ac-adr-019-apply-security-and-privacy-controls-at-every-trust-boundary.short.md
- skills/architecture-compass/references/ac-adr-020-define-data-ownership-tenancy-retention-and-deletion-before-access-paths.guide.md
- skills/architecture-compass/references/ac-adr-020-define-data-ownership-tenancy-retention-and-deletion-before-access-paths.long.md
- skills/architecture-compass/references/ac-adr-020-define-data-ownership-tenancy-retention-and-deletion-before-access-paths.short.md
- skills/architecture-compass/references/ac-adr-021-preserve-compatibility-through-explicit-migrations-and-deprecation-windows.guide.md
- skills/architecture-compass/references/ac-adr-021-preserve-compatibility-through-explicit-migrations-and-deprecation-windows.long.md
- skills/architecture-compass/references/ac-adr-021-preserve-compatibility-through-explicit-migrations-and-deprecation-windows.short.md
- skills/architecture-compass/references/ac-adr-022-deliver-reversible-slices-with-explicit-rollback-and-promotion-gates.guide.md
- skills/architecture-compass/references/ac-adr-022-deliver-reversible-slices-with-explicit-rollback-and-promotion-gates.long.md
- skills/architecture-compass/references/ac-adr-022-deliver-reversible-slices-with-explicit-rollback-and-promotion-gates.short.md
- skills/architecture-compass/references/ac-adr-023-operate-services-with-observable-health-readiness-failure-and-cleanup.guide.md
- skills/architecture-compass/references/ac-adr-023-operate-services-with-observable-health-readiness-failure-and-cleanup.long.md
- skills/architecture-compass/references/ac-adr-023-operate-services-with-observable-health-readiness-failure-and-cleanup.short.md
- skills/architecture-compass/references/ac-adr-024-meet-an-explicit-accessibility-baseline-with-automated-and-manual-proof.guide.md
- skills/architecture-compass/references/ac-adr-024-meet-an-explicit-accessibility-baseline-with-automated-and-manual-proof.long.md
- skills/architecture-compass/references/ac-adr-024-meet-an-explicit-accessibility-baseline-with-automated-and-manual-proof.short.md
- skills/architecture-compass/references/ac-adr-025-set-measurable-performance-budgets-and-optimize-from-evidence.guide.md
- skills/architecture-compass/references/ac-adr-025-set-measurable-performance-budgets-and-optimize-from-evidence.long.md
- skills/architecture-compass/references/ac-adr-025-set-measurable-performance-budgets-and-optimize-from-evidence.short.md
- skills/architecture-compass/references/ac-adr-026-route-architecture-compass-through-explicit-setup-and-apply-pipelines.guide.md
- skills/architecture-compass/references/ac-adr-026-route-architecture-compass-through-explicit-setup-and-apply-pipelines.long.md
- skills/architecture-compass/references/ac-adr-026-route-architecture-compass-through-explicit-setup-and-apply-pipelines.short.md
- skills/architecture-compass/references/ac-adr-027-use-the-open-agent-skills-specification.guide.md
- skills/architecture-compass/references/ac-adr-027-use-the-open-agent-skills-specification.long.md
- skills/architecture-compass/references/ac-adr-027-use-the-open-agent-skills-specification.short.md
- skills/architecture-compass/references/ac-adr-028-keep-candidates-outside-the-promoted-public-catalog.guide.md
- skills/architecture-compass/references/ac-adr-028-keep-candidates-outside-the-promoted-public-catalog.long.md
- skills/architecture-compass/references/ac-adr-028-keep-candidates-outside-the-promoted-public-catalog.short.md
- skills/architecture-compass/references/ac-adr-029-promote-skills-through-an-evidence-and-maintenance-gate.guide.md
- skills/architecture-compass/references/ac-adr-029-promote-skills-through-an-evidence-and-maintenance-gate.long.md
- skills/architecture-compass/references/ac-adr-029-promote-skills-through-an-evidence-and-maintenance-gate.short.md
- skills/architecture-compass/references/ac-adr-030-license-public-skill-repositories-under-apache-2-0.guide.md
- skills/architecture-compass/references/ac-adr-030-license-public-skill-repositories-under-apache-2-0.long.md
- skills/architecture-compass/references/ac-adr-030-license-public-skill-repositories-under-apache-2-0.short.md
- skills/architecture-compass/references/ac-adr-031-keep-skill-evaluation-evidence-outside-the-runtime-payload.guide.md
- skills/architecture-compass/references/ac-adr-031-keep-skill-evaluation-evidence-outside-the-runtime-payload.long.md
- skills/architecture-compass/references/ac-adr-031-keep-skill-evaluation-evidence-outside-the-runtime-payload.short.md
- skills/architecture-compass/references/ac-adr-032-keep-maintainer-local-helper-state-out-of-public-repositories.guide.md
- skills/architecture-compass/references/ac-adr-032-keep-maintainer-local-helper-state-out-of-public-repositories.long.md
- skills/architecture-compass/references/ac-adr-032-keep-maintainer-local-helper-state-out-of-public-repositories.short.md
- skills/architecture-compass/references/ac-adr-033-choose-portable-dependency-light-skill-helpers.guide.md
- skills/architecture-compass/references/ac-adr-033-choose-portable-dependency-light-skill-helpers.long.md
- skills/architecture-compass/references/ac-adr-033-choose-portable-dependency-light-skill-helpers.short.md
- skills/architecture-compass/references/ac-adr-034-keep-release-metadata-coherent-with-public-catalog-changes.guide.md
- skills/architecture-compass/references/ac-adr-034-keep-release-metadata-coherent-with-public-catalog-changes.long.md
- skills/architecture-compass/references/ac-adr-034-keep-release-metadata-coherent-with-public-catalog-changes.short.md
- skills/architecture-compass/references/ac-adr-035-classify-skill-portability-before-choosing-host-variants.guide.md
- skills/architecture-compass/references/ac-adr-035-classify-skill-portability-before-choosing-host-variants.long.md
- skills/architecture-compass/references/ac-adr-035-classify-skill-portability-before-choosing-host-variants.short.md
- skills/architecture-compass/references/ac-adr-036-keep-architecture-compass-portable-through-host-adapters.guide.md
- skills/architecture-compass/references/ac-adr-036-keep-architecture-compass-portable-through-host-adapters.long.md
- skills/architecture-compass/references/ac-adr-036-keep-architecture-compass-portable-through-host-adapters.short.md
- skills/architecture-compass/references/ac-adr-037-preserve-target-contracts-and-gate-gateway-extraction.guide.md
- skills/architecture-compass/references/ac-adr-037-preserve-target-contracts-and-gate-gateway-extraction.long.md
- skills/architecture-compass/references/ac-adr-037-preserve-target-contracts-and-gate-gateway-extraction.short.md
- skills/architecture-compass/references/ac-adr-038-gate-optional-capabilities-and-tool-side-effects.guide.md
- skills/architecture-compass/references/ac-adr-038-gate-optional-capabilities-and-tool-side-effects.long.md
- skills/architecture-compass/references/ac-adr-038-gate-optional-capabilities-and-tool-side-effects.short.md
- skills/architecture-compass/references/ac-adr-039-prefer-existing-public-skills-conditionally.guide.md
- skills/architecture-compass/references/ac-adr-039-prefer-existing-public-skills-conditionally.long.md
- skills/architecture-compass/references/ac-adr-039-prefer-existing-public-skills-conditionally.short.md
- skills/architecture-compass/references/ac-adr-040-offer-an-opinionated-stack-profile-for-new-public-skill-repositories.guide.md
- skills/architecture-compass/references/ac-adr-040-offer-an-opinionated-stack-profile-for-new-public-skill-repositories.long.md
- skills/architecture-compass/references/ac-adr-040-offer-an-opinionated-stack-profile-for-new-public-skill-repositories.short.md
- skills/architecture-compass/references/ac-adr-041-publish-public-skills-through-github-and-the-open-skills-cli.guide.md
- skills/architecture-compass/references/ac-adr-041-publish-public-skills-through-github-and-the-open-skills-cli.long.md
- skills/architecture-compass/references/ac-adr-041-publish-public-skills-through-github-and-the-open-skills-cli.short.md
- skills/architecture-compass/references/ac-adr-042-calibrate-validation-to-change-risk-and-reuse-fresh-evidence.guide.md
- skills/architecture-compass/references/ac-adr-042-calibrate-validation-to-change-risk-and-reuse-fresh-evidence.long.md
- skills/architecture-compass/references/ac-adr-042-calibrate-validation-to-change-risk-and-reuse-fresh-evidence.short.md
- skills/architecture-compass/references/ac-adr-043-route-architecture-compass-through-explicit-setup-and-apply-pipelines-with-risk-based-validation.guide.md
- skills/architecture-compass/references/ac-adr-043-route-architecture-compass-through-explicit-setup-and-apply-pipelines-with-risk-based-validation.long.md
- skills/architecture-compass/references/ac-adr-043-route-architecture-compass-through-explicit-setup-and-apply-pipelines-with-risk-based-validation.short.md
- skills/architecture-compass/references/ac-adr-044-record-material-decision-lineage-in-non-normative-guides.guide.md
- skills/architecture-compass/references/ac-adr-044-record-material-decision-lineage-in-non-normative-guides.long.md
- skills/architecture-compass/references/ac-adr-044-record-material-decision-lineage-in-non-normative-guides.short.md
- skills/architecture-compass/references/ac-adr-045-route-architecture-compass-through-setup-audit-and-refactor-with-intent-bound-agent-selection.guide.md
- skills/architecture-compass/references/ac-adr-045-route-architecture-compass-through-setup-audit-and-refactor-with-intent-bound-agent-selection.long.md
- skills/architecture-compass/references/ac-adr-045-route-architecture-compass-through-setup-audit-and-refactor-with-intent-bound-agent-selection.short.md
- skills/architecture-compass/references/ac-adr-046-rank-architecture-evidence-without-expanding-operational-authority.guide.md
- skills/architecture-compass/references/ac-adr-046-rank-architecture-evidence-without-expanding-operational-authority.long.md
- skills/architecture-compass/references/ac-adr-046-rank-architecture-evidence-without-expanding-operational-authority.short.md
- skills/architecture-compass/references/ac-adr-047-separate-low-and-moderate-validation-risk-with-explicit-triggers.guide.md
- skills/architecture-compass/references/ac-adr-047-separate-low-and-moderate-validation-risk-with-explicit-triggers.long.md
- skills/architecture-compass/references/ac-adr-047-separate-low-and-moderate-validation-risk-with-explicit-triggers.short.md
- skills/architecture-compass/references/ac-adr-048-persist-approved-governance-before-planned-architecture-refactors.guide.md
- skills/architecture-compass/references/ac-adr-048-persist-approved-governance-before-planned-architecture-refactors.long.md
- skills/architecture-compass/references/ac-adr-048-persist-approved-governance-before-planned-architecture-refactors.short.md
- skills/architecture-compass/references/ac-adr-049-distinguish-change-risk-from-representative-environment-observation.guide.md
- skills/architecture-compass/references/ac-adr-049-distinguish-change-risk-from-representative-environment-observation.long.md
- skills/architecture-compass/references/ac-adr-049-distinguish-change-risk-from-representative-environment-observation.short.md
- skills/architecture-compass/references/ac-adr-050-use-semantic-status-markers-in-user-facing-receipts.guide.md
- skills/architecture-compass/references/ac-adr-050-use-semantic-status-markers-in-user-facing-receipts.long.md
- skills/architecture-compass/references/ac-adr-050-use-semantic-status-markers-in-user-facing-receipts.short.md
- skills/architecture-compass/references/ac-adr-051-route-architecture-compass-through-public-and-internal-decision-namespaces.guide.md
- skills/architecture-compass/references/ac-adr-051-route-architecture-compass-through-public-and-internal-decision-namespaces.long.md
- skills/architecture-compass/references/ac-adr-051-route-architecture-compass-through-public-and-internal-decision-namespaces.short.md
- skills/architecture-compass/references/ac-adr-052-persist-agent-governance-through-host-neutral-repository-surfaces.guide.md
- skills/architecture-compass/references/ac-adr-052-persist-agent-governance-through-host-neutral-repository-surfaces.long.md
- skills/architecture-compass/references/ac-adr-052-persist-agent-governance-through-host-neutral-repository-surfaces.short.md
- skills/architecture-compass/references/ac-adr-053-use-capability-aware-presentation-profiles-for-portable-agent-receipts.guide.md
- skills/architecture-compass/references/ac-adr-053-use-capability-aware-presentation-profiles-for-portable-agent-receipts.long.md
- skills/architecture-compass/references/ac-adr-053-use-capability-aware-presentation-profiles-for-portable-agent-receipts.short.md
- skills/architecture-compass/references/ac-adr-054-isolate-agent-writes-in-external-git-worktrees.guide.md
- skills/architecture-compass/references/ac-adr-054-isolate-agent-writes-in-external-git-worktrees.long.md
- skills/architecture-compass/references/ac-adr-054-isolate-agent-writes-in-external-git-worktrees.short.md
- skills/architecture-compass/references/ac-adr-055-separate-change-impact-from-generated-release-publication.guide.md
- skills/architecture-compass/references/ac-adr-055-separate-change-impact-from-generated-release-publication.long.md
- skills/architecture-compass/references/ac-adr-055-separate-change-impact-from-generated-release-publication.short.md
- skills/architecture-compass/references/ac-adr-056-preserve-release-candidates-through-verified-protected-history.guide.md
- skills/architecture-compass/references/ac-adr-056-preserve-release-candidates-through-verified-protected-history.long.md
- skills/architecture-compass/references/ac-adr-056-preserve-release-candidates-through-verified-protected-history.short.md
- skills/architecture-compass/references/ac-adr-057-separate-metadata-repair-from-installable-artifact-provenance.guide.md
- skills/architecture-compass/references/ac-adr-057-separate-metadata-repair-from-installable-artifact-provenance.long.md
- skills/architecture-compass/references/ac-adr-057-separate-metadata-repair-from-installable-artifact-provenance.short.md
- skills/architecture-compass/references/ac-adr-058-use-pnpm-for-package-management-and-bun-for-execution.guide.md
- skills/architecture-compass/references/ac-adr-058-use-pnpm-for-package-management-and-bun-for-execution.long.md
- skills/architecture-compass/references/ac-adr-058-use-pnpm-for-package-management-and-bun-for-execution.short.md
- skills/architecture-compass/references/adr-catalog.md
- skills/architecture-compass/references/internal/internal-adr-001-resolve-persistence-surfaces-before-writes.guide.md
- skills/architecture-compass/references/internal/internal-adr-001-resolve-persistence-surfaces-before-writes.long.md
- skills/architecture-compass/references/internal/internal-adr-001-resolve-persistence-surfaces-before-writes.short.md
- skills/architecture-compass/references/internal/internal-adr-002-select-capability-aware-receipt-renderers.guide.md
- skills/architecture-compass/references/internal/internal-adr-002-select-capability-aware-receipt-renderers.long.md
- skills/architecture-compass/references/internal/internal-adr-002-select-capability-aware-receipt-renderers.short.md
- skills/architecture-compass/references/internal/internal-adr-index.md
Every link opens the file at its source, pinned to the revision this page describes.