Skip to content

Adopt the profiled repository contract - #1

Merged
evanfollis merged 1 commit into
mainfrom
agent/adr-0050-repository-contract
Jul 26, 2026
Merged

Adopt the profiled repository contract#1
evanfollis merged 1 commit into
mainfrom
agent/adr-0050-repository-contract

Conversation

@evanfollis

Copy link
Copy Markdown
Owner

Adds the ADR-0050 repository declaration, universal make check interface, architecture/front-door documentation, pinned least-privilege CI, and Dependabot configuration. Shape-specific checks preserve existing domain boundaries. Dated exceptions remain explicit, so this does not claim full conformance before prompt-eval, typing, runtime-path, dependency-lock, or host-containment gaps close.

@evanfollis
evanfollis marked this pull request as ready for review July 26, 2026 20:49
Copilot AI review requested due to automatic review settings July 26, 2026 20:50
@evanfollis
evanfollis merged commit af5a4e7 into main Jul 26, 2026
1 check passed
@evanfollis
evanfollis deleted the agent/adr-0050-repository-contract branch July 26, 2026 20:50

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Introduces a repository-level contract for the “builder context” shape, including a declarative repo.toml, documentation describing canonical vs non-canonical artifacts, and a single make check entrypoint that is enforced in CI.

Changes:

  • Adds repo.toml and scripts/check_context.py to validate required paths plus the skillfoundry.toml repository/frontdoor declarations.
  • Adds make check and wires it into a least-privilege GitHub Actions workflow.
  • Documents the contract and transition exceptions via AGENTS.md, CLAUDE.md, docs/architecture.md, and a README update; adds Dependabot for GitHub Actions.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
scripts/check_context.py Implements contract validation for required repo structure and pinned front-door files.
repo.toml Declares repository schema/version, shape, and authoritative artifact roots.
README.md Adds lifecycle/verification section pointing to make check and architecture doc.
Makefile Provides make check entrypoint for contract validation and patch hygiene checks.
docs/architecture.md Documents artifact roles (canon vs non-canon) and dated transition exceptions.
CLAUDE.md Adds Claude adapter front-door instruction pointer to AGENTS + pinned paths.
AGENTS.md Defines the builder-context contribution/contract expectations and make check guidance.
.github/workflows/check.yml Adds CI workflow to run make check with pinned action SHAs.
.github/dependabot.yml Enables monthly updates for GitHub Actions dependencies.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread scripts/check_context.py
Comment on lines +20 to +22
for path in context.get("frontdoor", {}).get("pinned_paths", []):
if not (ROOT / path).is_file():
raise SystemExit(f"missing pinned front-door path: {path}")
Comment thread Makefile
@printf '%s\n' 'make check Validate context declaration, pinned front door, and patch hygiene'
check:
python3 scripts/check_context.py
git diff --check
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants