Repository navigation
docs: reconcile instruction files that disagreed with each other - #188
Conversation
The preflight said to read all of two docs and then only the relevant sections; the second sentence now scopes the live upstream pages. AGENTS.md and the migration playbook restated the $plugin-creator removal as a version history note. They now state the current rule and point at the cheat sheet, the dated record, whose guide claim is brought up to the wording the packaging guide uses today. AGENTS.md listed five behavioral test cases where the release gates list seven; it now cites the release gates and the playbook matrix. migrate-plugin told an installed copy to act "in this marketplace", which it cannot detect; the step now applies when the active repository has the named files. plugin-ops 0.2.5. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015XWwmeQBXsRaYpmqMJbwsf
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
|
claude-security-review needs no new review of No security findings. I posted no inline comments. Scope: All 6 files are documentation, one skill text edit, a version bump ( Instruction-surface lens: I read each softened instruction, and none removes a control.
Manifest: The only
critical-findings: 0 |
|
claude-review reviewed Incremental review of No findings. I did not run the tests or the validator and did not re-check the live upstream page. The date and verification are the author's claim. Verifier dropped 0 of 0 candidates. |
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015XWwmeQBXsRaYpmqMJbwsf
No related issue: findings from a prompt audit of this repository's instruction files, fixed in the same session.
Summary
Five places where instruction files disagreed with each other or with the repository's own standards. Documentation and one skill sentence; no behavior of the validator or scripts changes.
AGENTS.md, the playbook, the cheat sheet ormigrate-plugingets one answer per question.AGENTS.md, repository docs, oneSKILL.md. No new mechanism.migrate-pluginstep 2 now applies the repository preflight only when the active repository has the named files; otherwise it falls back to the official-documentation fetch in the same step.Fix
AGENTS.mdpreflight: "Read only the sections relevant" contradicted "read all of" two docs. It now scopes the live upstream pages, matchingdocs/official-docs.md("Read the smallest complete set").docs/codex-capability-cheat-sheet.md: the guide claim said only "@plugin-creatoras a built-in in ChatGPT"; the copies added in fix(plugin-ops): stop citing the removed $plugin-creator skill #114 were fuller. Brought up to the guide's current wording.AGENTS.mdanddocs/migration-playbook.md: the$plugin-creatorremoval was restated as a version history note (docs/standards/reference-dont-duplicate.md, "History lives in version control"). Both now state the current rule and link the cheat sheet, which holds the version, date and recheck trigger.README.mdand the two skills keep their copies: onboarding prose may restate, and an installed skill cannot link repository docs.AGENTS.mdvalidation: listed five behavioral cases where the release gates list seven. It now cites the release gates and the playbook matrix.plugins/plugin-ops/skills/migrate-plugin/SKILL.md: "In this marketplace" is not something an installed copy can detect. Now "When the active repository has them".plugin-ops0.2.4 to 0.2.5.Verification
npm test: 202 pass, 0 fail, 0 skipped.npm run validate: PASS, 0 errors, 0 warnings.lychee --offlineon the three edited docs: 0 errors (the two new anchors resolve).@plugin-creatorin Work mode in ChatGPT and$plugin-creatorin Codex, which is what fix 2 records.$skill-creatorquick validator and a behavioral run ofmigrate-pluginin a new Codex task. This session has no Codex CLI task surface; the changed sentence is covered structurally bytests/plugin-ops-plugin.test.mjs.Related
🤖 Generated with Claude Code
https://claude.ai/code/session_015XWwmeQBXsRaYpmqMJbwsf