Teaching Partner quality audit
Teaching Partner quality audit
Section titled “Teaching Partner quality audit”PowerAdvice must match or exceed the Teaching Partner documentation quality bar before AD-376 can close.
Current verified receipts
Section titled “Current verified receipts”- Docs OS content audit:
npm run docs:poweradvice:auditreportsok: true,sections: 8,screenshots: 8. - Docs OS report:
npm run docs:reportreports thecms-astroprofile, thedocs-sitepath, thecmssite, and all eight maintained CMS routes. - Docs OS verification:
npm run docs:verifypasses build, route, frontmatter, image, link, and manifest checks. - UAT deployment: PR #931 merged at
80bd2d26a95261fd653a781d643b4c3dd3cededb; Deploy Docs UAT run30518311967succeeded;https://docs-uat.poweradvice.com/returns HTTP 200 with the titlePowerAdvice CMS documentation | PowerAdvice CMS Docs. - Audience source map: Tory and LeeAnn source audit maps Gmail, Google Docs, and PostHog evidence to maintained documentation coverage.
- Design standard: Docs design standard defines screenshot, callout, task-card, decision, and recovery standards.
The remaining parent acceptance work is tracked in the child issues named below. This page is the maintained audit record; it should be updated with final runtime, screenshot, Access, and update-route receipts before AD-376 closes.
| Rubric item | Current Docs OS evidence |
|---|---|
| Four-part information architecture | Getting Started, Guides, Reference, Troubleshooting are present. |
| Every visible CMS section mapped | See CMS inventory. |
| Workflow pages include purpose, prerequisites, steps, resulting state, permissions, failures, recovery | npm run docs:poweradvice:audit checks every required guide page for the required operator sections. |
| Authenticated screenshots show workflow states | Manifest tracks section-level workflow screenshots; final authenticated UAT/staging capture receipt remains owned by AD-379. |
| Deterministic non-production synthetic data | Required by screenshot policy; final authenticated capture receipt remains owned by AD-379. |
| Screenshot manifest has no missing/orphaned/stale assets | Enforced by npm run docs:screenshots:check. |
| No production personal data or secrets | Enforced by screenshot policy and review. |
| Links, images, frontmatter, navigation, builds pass | Enforced by npm run docs:verify and npm run docs:poweradvice:audit. |
| CMS Help links resolve to the appropriate environment | UAT wiring is present through PUBLIC_DOCS_URL; final runtime Help-link receipts across required environments remain owned by AD-380. |
| Access challenge and authenticated route smoke pass | Final docs Access challenge and authenticated route receipts remain owned by AD-380. |
| Docs deployment is revision-locked to application commit | UAT deployment receipt is recorded above; final revision-lock receipt across required environments remains owned by AD-380. |
| Parent and Cursor update routes both pass | Required before AD-376 close; no additional platform work is owned from this PowerAdvice audit page. |
| Side-by-side audit records Teaching Partner parity | This page records the PowerAdvice parity audit and points failed/unproven runtime items to AD-379 and AD-380 before AD-376 close. |