This directory collects the deeper project documentation that does not belong on the README front page.
- ../README.md - project overview, quick start, and repository map
- ../CONTRIBUTING.md - contributor workflow and repository rules
- architecture.md - components, boundaries, state model, and platform differences
- distribution.md - packaging status and why
superpowersremains a runtime dependency - codex-marketplace.md - how Codex discovers local marketplaces and plugin bundles
- codex-hooks.md - why issue-flow no longer relies on Codex SessionStart hook context injection
- testing.md - test suites, commands, and when to run them
- If you are evaluating the project, start with the root README.
- If you are installing the project, read the installation section in
README.md. - If you are changing workflow behavior, start with
architecture.mdandtesting.md. - If you are preparing a pull request, read
CONTRIBUTING.md.