Auditors: The QG-IP-CONS Quality Gate + How to Audit the Patent Mirror¶
FCC v1.4.3 introduced ai-coe-docs as the single source of truth
for ecosystem patent material, and fcc.validation.patent_mirror
detects drift between FCC's docs/patent/ tree and the sibling
mirror. The QG-IP-CONS quality gate enforces this contract. These
five prompts walk an auditor through a full audit.
Personas Used¶
| Persona ID | Full Name | Role |
|---|---|---|
| aud | Compliance Auditor | Runs the audit |
| ipe | IP Evaluation Analyst | IP subject-matter review |
| gov | Governance Lead | Gate enforcement policy |
Prompt 1: Locate the Artifacts¶
Personas: aud
Prompt¶
Produce a full inventory of the audit surface:
1. docs/patent/ tree in FCC (count .md files)
2. docs/patent/fcc/ mirror in ai-coe-docs (count .md files)
3. The three SIBLING_CANDIDATES path tuples
fcc.validation.patent_mirror probes.
4. The QG-IP-CONS quality gate YAML entry.
Deliverable: a Markdown inventory block with per-item counts.
Expected Output¶
- File counts
- Sibling candidate paths
- Gate YAML excerpt
Prompt 2: Run the Drift Check¶
Personas: aud
Prompt¶
Run fcc.validation.patent_mirror.check_mirror(Path.cwd()) and
capture the MirrorReport list. Categorize each entry by
reason: "not found in mirror", "SHA256 mismatch", "mirror
unreachable", or "clean". Produce a summary table.
Expected Output¶
- Raw report dump
- Categorized summary
- Top-5 drifted paths
Prompt 3: Triage Drift¶
Personas: ipe, aud
Prompt¶
For each SHA256-mismatch entry, decide:
- FCC is ahead: propose a mirror-update PR title.
- Mirror is ahead: propose a FCC sync PR title.
- Both diverged: ROAM vote (Resolved / Owned / Accepted / Mitigated).
Keep each decision to one line.
Expected Output¶
- Per-drift verdict
- PR title list
- ROAM notes where needed
Prompt 4: Gate Enforcement¶
Personas: gov
Prompt¶
The QG-IP-CONS gate is advisory through v1.4.3.x and required in
v1.4.4+. Propose the CI job that enforces it:
1. Shell to run fcc audit patent-mirror --strict
2. Exit non-zero on any drifted: true entry (unless advisory).
3. Post a PR comment with the Markdown summary table.
Deliverable: a GitHub Actions workflow stanza.
Expected Output¶
- Workflow stanza
- Exit-code semantics
- PR comment body
Prompt 5: Audit Report¶
Personas: aud, ipe
Prompt¶
Assemble the 1-page audit report for management: scope, method,
findings (counts by category), risk assessment, and three
recommendations. Cite OPEN-SCI-009 (archival integrity) and
OPEN-SCI-012 (provenance) as the scientific framing.
Expected Output¶
- 1-page audit report
- Findings by count
- Three concrete recommendations
See Also¶
- Notebook 41 — Patent mirror drift demo
src/fcc/validation/patent_mirror.pydocs/tutorials/sample-prompts/cross-cutting-patent-delegation.md