Feature: Capacitor audit agent -- playground-to-app promotion readiness checker

### Type Feature ### Lineage Standalone -- migrated from `todo-capacitor-audit-agent` in pal-e-docs. Depends on `sop-capacitor-mobile-lifecycle` @comment spec format being locked first. ### Repo `forgejo_admin/claude-custom` ### User Story As a developer promoting a playground to a Capacitor app, I want an automated audit agent that cross-references playground HTML specs against backend API endpoints, So that integration gaps are caught before any Svelte code is written. ### Context The playground-to-Capacitor transition is the highest-leverage quality gate. An automated audit catches integration gaps before any Svelte code is written. The agent would: 1. Read all playground HTML files and their @-comment specs 2. Read the target API's route files to build endpoint inventory 3. Cross-reference: does every @api declaration have a matching backend endpoint? 4. Flag @gaps -- missing endpoints, incomplete state declarations, undefined interactivity 5. Verify single-CSS/single-JS input contract (zero inline styles/scripts) 6. Produce a promotion readiness report ### File Targets Files the agent should modify or create: - `skills/capacitor-audit.md` -- new skill definition for the audit agent - `agents/capacitor-audit.md` -- agent profile (if warranted as separate agent vs skill) Files the agent should NOT touch: - `sop-capacitor-mobile-lifecycle` -- dependency, not modified by this work ### Acceptance Criteria - [ ] Agent reads playground HTML files and extracts @-comment specs - [ ] Agent reads target API routes and builds endpoint inventory - [ ] Cross-reference report identifies missing endpoints and incomplete specs - [ ] Single-CSS/single-JS contract verified (zero inline styles/scripts) - [ ] Promotion readiness report generated with clear pass/fail ### Test Expectations - [ ] Manual test: run against westside-playground with basketball-api -- produces accurate report - [ ] Manual test: introduce a missing endpoint -- audit catches it ### Constraints - Depends on `sop-capacitor-mobile-lifecycle` @comment spec format being finalized - Must work across any playground/API pair, not hardcoded to westside ### Checklist - [ ] PR opened - [ ] Tests pass - [ ] No unrelated changes ### Related - `pal-e-agency` -- project - claude-custom #117 - `sop-capacitor-mobile-lifecycle` -- dependency

forgejo_admin commented

2026-03-28 02:05:59 +00:00

Contributor

Type

Feature

Lineage

Standalone -- migrated from todo-capacitor-audit-agent in pal-e-docs. Depends on sop-capacitor-mobile-lifecycle @comment spec format being locked first.

Repo

forgejo_admin/claude-custom

User Story

As a developer promoting a playground to a Capacitor app,
I want an automated audit agent that cross-references playground HTML specs against backend API endpoints,
So that integration gaps are caught before any Svelte code is written.

Context

The playground-to-Capacitor transition is the highest-leverage quality gate. An automated audit catches integration gaps before any Svelte code is written. The agent would:

Read all playground HTML files and their @-comment specs
Read the target API's route files to build endpoint inventory
Cross-reference: does every @api declaration have a matching backend endpoint?
Flag @gaps -- missing endpoints, incomplete state declarations, undefined interactivity
Verify single-CSS/single-JS input contract (zero inline styles/scripts)
Produce a promotion readiness report

File Targets

Files the agent should modify or create:

skills/capacitor-audit.md -- new skill definition for the audit agent
agents/capacitor-audit.md -- agent profile (if warranted as separate agent vs skill)

Files the agent should NOT touch:

sop-capacitor-mobile-lifecycle -- dependency, not modified by this work

Acceptance Criteria

Agent reads playground HTML files and extracts @-comment specs
Agent reads target API routes and builds endpoint inventory
Cross-reference report identifies missing endpoints and incomplete specs
Single-CSS/single-JS contract verified (zero inline styles/scripts)
Promotion readiness report generated with clear pass/fail

Test Expectations

Manual test: run against westside-playground with basketball-api -- produces accurate report
Manual test: introduce a missing endpoint -- audit catches it

Constraints

Depends on sop-capacitor-mobile-lifecycle @comment spec format being finalized
Must work across any playground/API pair, not hardcoded to westside

Checklist

PR opened
Tests pass
No unrelated changes

pal-e-agency -- project
claude-custom #117
sop-capacitor-mobile-lifecycle -- dependency

Rows
Columns

Feature: Capacitor audit agent -- playground-to-app promotion readiness checker #188