# 14. README, help text, and end-to-end integration

meta:
  id: pygienium-14
  feature: pygienium
  priority: P2
  depends_on: [pygienium-12, pygienium-13]
  tags: [docs, integration]

objective:

- Author the README and full help text, then run an end-to-end integration pass over the whole extension to verify all commands, the registry extensibility claim, and the exit criteria.

deliverables:

- `pygienium/README.md`: what it is, install, commands, flags, how to add a check (one file + registerCheck)
- `src/help.ts` fully populated: per-command usage/does/example + CLI flag help, mirroring piolium's help.ts
- `/pygienium-help` renders the full help block
- Extensibility verification: add a new check in `checks/` + one registry line with NO index.ts command changes; confirm a new `/pygienium-<new>` command appears

steps:

- Write README sections: overview, the five checks, commands, flags, adding a check, architecture (sub-agent loops)
- Populate help.ts COMMANDS + CLI_FLAGS arrays from the actual commands/flags implemented in 06-13
- Extensibility test: create `checks/noop.ts` registering `registerCheck({name:"noop",...})`, reload, confirm `/pygienium-noop` exists and `/pygienium-help` lists it
- Run `/pygienium-all` end-to-end on this repo and confirm the exit criteria

tests:

- Integration: `/pygienium-help` lists all 8+ commands and all flags
- Integration: a newly registered check auto-creates its command without index.ts edits
- Integration: `/pygienium-all` completes with all checks marked complete

acceptance_criteria:

- README documents install, commands, flags, and the one-file extensibility workflow
- `/pygienium-help` output matches the implemented commands/flags exactly
- A new check file + registerCheck entry yields a working `/pygienium-<name>` command with zero index.ts changes
- All exit criteria from the feature README pass

validation:

- `pi -p "/pygienium-help"` prints the full help
- Add the noop check, `/reload`, run `/pygienium-noop`, confirm success
- Run `/pygienium-all` and inspect the final summary

notes:

- This is the acceptance gate for the whole feature
- If the extensibility claim fails here, refactor the registry in task 06 before declaring done