Make the systems guidance more approachable - #6
Conversation
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 0cb1a8a193
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| validate_public_safety(root, errors) | ||
| validate_neutral_editorial_voice(root, errors) | ||
| validate_external_urls(root, errors) |
There was a problem hiding this comment.
Preserve a privacy guard for autobiographical prose
When a contributor adds autobiographical material such as “I built this for my employer” or describes a private customer incident, the remaining PRIVATE_PATTERNS detect none of it, so validation now passes despite CONTRIBUTING.md explicitly prohibiting autobiographical, employer, customer, and private-incident details. Allowing first-person opinions does not require removing the only automated guard against this newly permitted form of prose; replace the blanket rule with a narrower privacy safeguard rather than dropping the check entirely.
Useful? React with 👍 / 👎.
Summary
Why
The compounding-systems direction is useful, but the previous pass made advanced architecture sound like the default for ordinary work. This keeps the deeper model while making the guide easier to understand and more natural to use.
Safety
Verification
python3 -m py_compile scripts/validate_content.py tests/test_validate_content.pypython3 scripts/validate_content.pypython3 -m unittest discover -s tests -vxmllint --noout assets/agentic-harness-topologies.svg assets/codexmaxxing-loop.svg assets/thinking-abstraction-level.svggit diff --check