refactor: clear doc comment grandfathered map, remove superpowers, fix orphaned docs

Fix all 68 TestDocCommentStructure violations by adding missing
Parameters: and Returns: sections to exported function doc comments
across 31 files. Set grandfatheredDocStructure to 0.

Remove docs/superpowers/ (external skill dependency that arrived
via feature branch merge). Extract useful patterns into
specs/superpowers-analysis.md.

Add reference/audit-conventions.md to site nav and reference index
(was orphaned — existed but unreachable).

Spec: specs/superpowers-analysis.md

Signed-off-by: Jose Alekhinne <jose@ctx.ist>

Author: josealekhine

.context/TASKS.md

@@ -99,12 +99,10 @@ TASK STATUS LABELS:
   .ctxrc or settings.json. Related: consolidation nudge hook
   spec. #added:2026-03-23-223500
 
-
 - [ ] Design UserPromptSubmit hook that runs go build and
   surfaces compilation errors before the agent acts on stale
   assumptions #added:2026-03-23-120136
 
-
 - [ ] Architecture Mapping (Enrichment):
   **Context**: Skill that incrementally builds and maintains
   ARCHITECTURE.md and DETAILED_DESIGN.md. Coverage tracked in

docs/reference/index.md

@@ -52,6 +52,13 @@ sensitive values that travel with the project.
 
 ---
 
+### [Audit Conventions](audit-conventions.md)
+
+Common patterns and fixes for the AST compliance tests in
+`internal/audit/`. When a test fails, find the matching section.
+
+---
+
 ### [Version History](versions.md)
 
 Changelog for every `ctx` release.