Skip to content

Rename domain glossary to GLOSSARY.md - #834

Merged
JacobStephens2 merged 10 commits into
mainfrom
issue-812
Oct 19, 2026
Merged

JacobStephens2 merged 10 commits into
mainfrom
issue-812

Conversation

@JacobStephens2

@JacobStephens2 JacobStephens2 commented Oct 19, 2026 •

Copy link
Copy Markdown
Owner

Summary

- CONTEXT.md
+ GLOSSARY.md
  agent guidance, Factory skills, Session prompts, site and local research links

Preserve the glossary contents and update agent guidance, Factory skills, generated prompts, site links and local research references. Align multi-context guidance with GLOSSARY-MAP.md. Historical plan replays and external-project citations retain the filenames present in their snapshots.

Closes #812

Evidence

  • Before: cargo test prompts_page failed on the old filename in the generated architecture prompt and site; cd site && npm run docs:check rejected the stale manual.
    After: regenerated from source with UPDATE_PROMPTS=1 cargo test prompts_page and cd site && npm run docs; cargo test prompts_page passes all 11 tests and cd site && npm test passes all 20 browser tests. Three prompt-page interaction tests also pass after regeneration.
  • Before: the Spec review's exact reproducer failed: plan One Launch directory module opens the Launch directory for every command #359 requested GLOSSARY.md, while its pinned historical commit contains only CONTEXT.md. The retained regression test also failed.
    After: preserve that historical prompt's filename; the exact reproducer and python3 -m unittest discover -s scripts -p 'test_*.py' pass (2 tests).
  • Glossary contents match current main byte-for-byte. cargo fmt --check, cargo clippy --all-targets -- -D warnings, and the focused review-report retention test pass. Full cargo test passed at 8493e5e; all application, skills, site and test sources are identical after reconciliation with the published branch and newer main. Final prompt checks (11), Python tests (2), manual generation check, and migrated research-link checks pass after reconciliation.

Seams under test: the binary's rendered Session prompts and embedded Factory skills; the generated manual and static site's browser interface; review-report retention through each Harness session; the replay script's rendered historical plan-check prompt.

Merge Danger

Door: two-way

Blast Radius: documentation

Readers and agent sessions must use the new glossary path. No glossary definitions change.

Unaddressed findings

  • Standards: none.
  • Spec: none. The P2 historical replay finding was reproduced and fixed, with a retained regression test.
  • Security: none.

Review coverage

Fresh independent Standards and Spec reviews against current main (d1e8c98) read all 40 changed files, including generated output, and the removed CONTEXT.md. No generated-output exclusions. Unread changed files: none. Standards: 0 findings. Spec: 1 P2 finding, addressed; no new findings after reconciliation.

The existing Security review at published head 9f546fe covered 36 changed paths against 02d96c0 and reported no introduced security findings. Its prior outcome is preserved below; it was not rerun for the final documentation links and regression test.

Security review outcome

No unaddressed introduced findings.

Built with codex · gpt-6.1-sol · high

CI notes

  • The reported CI run and Release run on 9f546fe were cancelled when the b97872e workflows were created at 17:12:25 UTC; both unchanged workflows cancel superseded PR runs, the macOS aggregate reports RESULT: cancelled, and the available shard logs contain cancellation errors without test assertion failures. Linux tests, site tests and the Linux release build passed in those runs.

@JacobStephens2
JacobStephens2 merged commit d3a13ba into main Oct 19, 2026
18 checks passed
@JacobStephens2
JacobStephens2 deleted the issue-812 branch October 19, 2026 19:37
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.

rename CONTEXT.md to GLOSSARY.md and the references to CONTEXT.md accordingly

1 participant