Skip to content

docs: scaffold example integrations repository#1

Merged
rlippmann merged 2 commits into
mainfrom
codex/repo-scaffold
Jun 12, 2026
Merged

docs: scaffold example integrations repository#1
rlippmann merged 2 commits into
mainfrom
codex/repo-scaffold

Conversation

@rlippmann

Copy link
Copy Markdown
Owner

Summary

  • Establish the initial scaffold for context-compiler-example-integrations.
  • Replace the initial MIT license with Apache-2.0 for Context Compiler ecosystem consistency.
  • Add repository governance docs, contribution guidance, issue templates, and PR template.
  • Add the enforcement-point-first README positioning and example catalog.
  • Create placeholder Python and TypeScript example trees.
  • Add minimal scaffold validation CI.
  • Add mixed Python/TypeScript .gitignore.

Why

This repository exists to answer:

Where can authority be enforced?

The scaffold establishes the repo boundary before any examples are migrated or implemented:

  • context-compiler: what is the authority contract?
  • context-compiler-directive-drafter: how is authority acquired?
  • context-compiler-example-integrations: where can authority be enforced?

This PR intentionally contains repository scaffolding and governance only.

Example metadata

  • Enforcement point: Repository scaffolding / governance
  • Domain: N/A
  • Technology/runtime: GitHub repository infrastructure
  • Example type: repository maintenance
  • Does this use directive drafter? should normally be no: No
  • Does this derive state from model output? must be no for primary examples: No

Checklist

  • Repository scaffolding / governance change
  • One primary enforcement point
  • Explicit authoritative state
  • No model-derived state mutation
  • Adversarial stub or equivalent test
  • Observable runtime behavior change
  • Domain vocabulary is natural
  • Framework is secondary to the enforcement point
  • Docs updated
  • Tests/smoke checks added where practical

Notes

Example-specific checklist items are satisfied as not applicable for this repository-maintenance scaffold. No examples are migrated or implemented in this PR.

Included:

  • README / CONTRIBUTING / AGENTS / SECURITY / CODE_OF_CONDUCT
  • GitHub issue and PR templates
  • Apache-2.0 license
  • minimal CI workflow
  • Python and TypeScript placeholder directory trees
  • mixed Python/TypeScript .gitignore

Not included:

  • example migrations
  • new example implementations
  • package publishing
  • TypeScript directive-drafter work
  • runtime-specific integrations

@rlippmann rlippmann merged commit e2fb94f into main Jun 12, 2026
1 check passed
@rlippmann rlippmann deleted the codex/repo-scaffold branch June 12, 2026 03:58
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.

1 participant