README.md

# Product & App Architect — v0.2.0

A skills-only product architecture and planning plugin. It turns ideas, user journeys, supplied screenshots, existing products and verified repositories into decisions, scoped specifications, UX flows, architecture and engineering handoffs.

## What changed
A single broad 0.1.0 skill was decomposed into 17 focused workflows. Original technical skill and six references are retained in `references/original/` as documentation, not as executable duplicate skill triggers. Reusable artifact templates, a deterministic traceability checker with tests, a benchmark suite, official source catalog and Tekris Labs publication metadata were added.

## Execution contract
This is **not** a code-generation/build service. It writes product and engineering specifications using enabled host tools and user-provided evidence. It cannot claim to have audited a source, run subagents, completed engineering tests or deployed an app unless those actions actually occurred.

## Entry points
- `skills/get-started/SKILL.md` routes broad requests.
- `skills/frame-opportunity/SKILL.md` handles idea framing.
- `skills/audit-existing-product/SKILL.md` inspects existing experiences.
- `skills/architect-application/SKILL.md` chooses architecture.
- `skills/plan-delivery/SKILL.md` produces engineering handoffs.

## Packaging
Root `plugin.json`, portable `skills/` directory and optional `.codex-plugin/plugin.json` compatibility manifest. No remote MCP server, credentials, app references or hooks. ZIP root contains these directly.

## Validation
`python3 scripts/validate_package.py` checks local packaging, asset references and manifest constraints.
`python3 -m unittest discover -s tests -v` runs offline helper tests.
The 24 scenario-based benchmarks in `benchmarks/cases.json` are **specifications, not executed live plugin tests**.