description: "Apothem harness adapter for GitHub Copilot (GA)."¶
GitHub Copilot¶
Vendor: GitHub / Microsoft
Install name: github-copilot
Status: GA
Native config: ~/.copilot/copilot-instructions.md (user-global, Copilot CLI)
Installation¶
apothem install --harness github-copilot
The adapter derives copilot-instructions.md from the shared profile CLAUDE.md and the rules corpus.
Files written: ~/.copilot/copilot-instructions.md
Profile-to-native-config mapping¶
The adapter reads the shared apothem profile (the installed source tree
under src/apothem/, plus the root CLAUDE.md and settings*.json)
and derives the GitHub Copilot-native config on every apothem install or
apothem update run.
The shared profile is the single source of truth; never edit native config
directly as your edits will be overwritten on the next sync.
Compatibility notes¶
GitHub Copilot does not support hooks. Only rule and instruction content is propagated.
The multi-surface coherence test at tests/fixtures/multi-surface-claims.yaml validates that copilot-instructions.md stays in sync with CLAUDE.md.
Verification¶
apothem verify --harness github-copilot
The verify command confirms that:
- The native config exists at the expected path.
- All mandatory fields from the shared profile are present.
- The adapter version matches the installed apothem version.
Updating¶
apothem update --harness github-copilot
Re-derives the native config from the current shared profile state.
Run after any change to CLAUDE.md, src/apothem/rules/,
or settings.json in the apothem source tree.
Uninstalling¶
apothem uninstall --harness github-copilot
Removes the native config files written by the adapter. The shared apothem profile (the source tree) is unaffected.
Conformity gate¶
python src/apothem/conformity/conformity-gate.py --harness github-copilot
Troubleshooting¶
| Symptom | Fix |
|---|---|
| Config file not found | Re-run apothem install --harness github-copilot |
| Adapter version mismatch | Run apothem update --harness github-copilot |
| Unexpected config content | Check the apothem source tree (src/apothem/, CLAUDE.md, settings*.json) — that is the source of truth |
Configuration knobs¶
| Flag | Default | Description |
|---|---|---|
--dry-run |
false |
Preview install without writing files. |