Initial commit: pygenium as git submodule

tasks/14-readme-help-integration.md

@@ -0,0 +1,50 @@
+# 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