docs(site): add ado-aw-debug reference page#749
Merged
jamesadevine merged 1 commit intoMay 25, 2026
Conversation
Port the complete ado-aw-debug documentation from docs/ado-aw-debug.md to the site as a reference page. This makes the debug-only front-matter section visible to site users: - create-issue safe output (three-layer gating, PAT setup, auto-footer) - skip-integrity flag (bypasses integrity verification step) Placed after Safe Outputs in the Reference section sidebar for logical grouping (debug tools follow regular safe outputs). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Open
jamesadevine
marked this pull request as ready for review
May 25, 2026 17:46
jamesadevine
deleted the
docs-site-add-ado-aw-debug-reference-19d0b4691bf7bccf
branch
May 25, 2026 17:46
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
ado-aw-debug:front-matter section, which was previously only documented indocs/ado-aw-debug.md.create-issuesafe output (three-layer gating, PAT setup, security checklist, auto-footer) and theskip-integrityflag.Changes
site/src/content/docs/reference/ado-aw-debug.mdx— new reference page porting the complete content fromdocs/ado-aw-debug.mdwith proper MDX formatting:ado-aw-debug:section with danger callout emphasizing dogfood-only usagecreate-issuedocumentation: three-layer gating model, front-matter schema, agent parameters, PAT setup, auto-footer format, security checklistskip-integrityflag documentation with rationalesite/astro.config.mjs— added{ label: 'ado-aw-debug', slug: 'reference/ado-aw-debug' }to the Reference section sidebar, positioned after Safe OutputsAccuracy checks
docs/ado-aw-debug.md(complete port)create-issuetool implementation confirmed insrc/safeoutputs/create_issue.rs:DEBUG_ONLY_TOOLS, compiler layer viaado-aw-debug.create-issue:, executor layer viadebug_enabled_toolsset)target-reporequired,title-prefix,labels,allowed-labels(default-deny),assignees,maxoptionaltitle,body,labels(optional),assignees(optional)ADO_AW_DEBUG_GITHUB_TOKENpipeline variable<!-- ado-aw -->markerskip-integrityflag verified in compiler and template marker behavior/ado-aw/reference/...)Validation
cd site && npm ci && npm run build— 30 pages built (up from 29), all internal links validCreated by the docs-writer workflow.