Skip to content

docs: fix AGENTS.md accuracy — add trigger-e2e to arch tree, add export-fact-catalog to hidden commands#1525

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/fix-agents-md-accuracy-c6bd85e567c7aeb3
Draft

docs: fix AGENTS.md accuracy — add trigger-e2e to arch tree, add export-fact-catalog to hidden commands#1525
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/fix-agents-md-accuracy-c6bd85e567c7aeb3

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

Agent Documentation Update

Findings

Area Issue File(s)
Accuracy trigger-e2e/ directory missing from scripts/ado-script/src/ architecture tree AGENTS.md
Accuracy Docs index only mentions export-gate-schema as a hidden build-time tool; export-fact-catalog (also #[command(hide = true)]) was not listed AGENTS.md

Applied Fixes

  • Added trigger-e2e/ entry to the scripts/ado-script/src/ section of the architecture tree with an accurate description (gate/synth-PR trigger-condition E2E harness, FACT_META gate-spec table, gate-spec.test.ts CI drift guard). Already fully documented in docs/ado-script.md; this restores consistency with the AGENTS.md map.
  • Updated the docs/cli.md index blurb to mention both export-gate-schema and export-fact-catalog as hidden build-time tools, matching their #[command(hide = true)] declarations in src/main.rs.

Notes

Verified against:

  • scripts/ado-script/src/ directory listing — trigger-e2e/ exists alongside executor-e2e/
  • docs/ado-script.md lines 109–115 and 568 — trigger-e2e already documented there
  • src/main.rs Commands enum — both ExportGateSchema and ExportFactCatalog carry #[command(hide = true)]

No other inaccuracies found in docs/, prompts/, or the AGENTS.md index after checking:

  • All CLI commands, front-matter fields, model names, schedule syntax
  • Safe-output tool list, FrontMatter struct fields, docs index links

Created by the agent-documentation maintainer workflow.

Generated by Agent Documentation Maintainer · 172.7 AIC · ⌖ 11.9 AIC · ⊞ 8.5K ·

…rt-fact-catalog to hidden commands

- Add missing `trigger-e2e/` entry to the `scripts/ado-script/src/` architecture
  tree (already documented in docs/ado-script.md but absent from the AGENTS.md map)
- Update docs/cli.md index blurb to mention both `export-gate-schema` and
  `export-fact-catalog` as hidden build-time tools (the code has both hidden
  with `#[command(hide = true)]`)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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.

0 participants