Update morgs32/llm-wiki
Update the canonical morgs32/llm-wiki source and deliver a ready pull request.
Never commit directly to main.
Scope
- Shared patterns live under
skills/patterns/references/patterns/**.
- Installable shared skills live under
skills/**.
- Workflows used only by this repository live under
.agents/skills/**.
- Root routing or publication policy lives in
AGENTS.md and README.md.
Do not edit installed ~/.agents/skills/** copies, a consuming repository's
{root}/llm-wiki/** tree, or any vendor subtree. Preserve unrelated local WIP.
Prepare the change
- Read the current remote
main SHA through the GitHub connector. If the
normal checkout contains unrelated changes or unresolved state, prepare the
requested patch in a clean isolated checkout of that exact SHA. Never stash,
reset, discard, resolve, or commit unrelated work.
- From that verified checkout, read root
AGENTS.md, the affected skill
entrypoint, and every directly linked instruction needed for the requested
change. Dirty or unpublished guidance does not define the patch.
- For a shared pattern change, read
skills/patterns/references/patterns/README.md and search
skills/patterns/references/patterns/index.md before editing. Ground the
pattern in a real example when one exists, update the pattern index in the
same pass, and keep repository-specific guidance out of the shared skill.
- For a skill change, load
$skill-creator, preserve supported metadata, and
update direct routing references when a name, path, or responsibility moves.
- For a skill rename, require explicit old and new names; do not infer either
from dirty WIP. Search every tracked file at the verified base SHA, and retain
the old name only in reviewed migration code, tests, or documentation.
Inspect installers, lock metadata, managed markers, and generated-install
behavior. Install and validate the new skill, migrate and validate every
requested repository marker, and only then remove a same-source legacy
installation. Preserve the legacy installation if any marker migration
fails, and refuse to remove an installation owned by another source.
- Make only the coherent requested pattern and skill changes. Keep pattern
sources, skill entrypoints, metadata, scripts, tests, indexes, and direct
documentation references consistent when the requested change affects them.
Validate
- Inspect the exact diff and run
git diff --check.
- Run the Codex skill validator on every added, renamed, or materially changed
skill directory.
- Check changed relative links and verify that removed names or paths have no
stale callers beyond deliberate migration code, tests, or documentation.
- Run targeted tests for every changed script. If no Nx target exists, invoke
the script's native test runner directly.
- Re-read remote
main. If it moved during preparation, rebuild the patch on
the new head and repeat validation.
Publish through a pull request
Treat “via PR”, “open a PR”, or “publish” as authorization to create the topic
branch, publication commit, and pull request. It does not authorize merge.
- Use
chatgpt-codex-connector for every GitHub mutation. Do not use a
personal-account Git push or gh.
- Create a non-
main <type>/<kebab-topic> branch from the exact verified
remote main SHA. Use a Conventional Commit type prefix (feat, fix,
docs, refactor, perf, test, build, ci, chore, revert) and
a short kebab-case slug. Prefer the prefix that matches the publication
commit's conventional type — for example docs(patterns): … on branch
docs/inline-one-call-simple-helpers. Do not use codex/ prefixes.
- Stage the coherent patch in the isolated checkout and record its exact
git write-tree SHA. Create the required blobs and tree from the verified
base tree, then require the connector-created tree SHA to equal the recorded
local tree SHA before creating one coherent conventional commit and
fast-forwarding the topic ref without force.
- Open a ready pull request against
morgs32/llm-wiki:main. Include the
behavioral split, migration details, and local validation in the body.
- Verify the pull request head SHA and exact changed-file list. Wait for the
validate-skills check and Codex review on that head; address in-scope
findings with connector-authored commits and revalidate the latest head.
- Stop with the pull request open unless the user separately authorizes merge
or auto-merge. Follow root
AGENTS.md for merge eligibility and gates; never
bypass branch protection.
Report the pull request URL, branch and head SHA, exact source areas changed,
and validation results. Do not refresh installed skills or downstream guidance
from an unmerged pull request.
1---2name: update-morgs32-llm-wiki3description: Update shared patterns or skill source in morgs32/llm-wiki and publish the coherent change through a GitHub pull request. Use from this repository when the user asks to change or publish its patterns or skills. Do not use for a consuming repository's local {root}/llm-wiki/** guidance.4---56# Update morgs32/llm-wiki78Update the canonical `morgs32/llm-wiki` source and deliver a ready pull request.9Never commit directly to `main`.1011## Scope1213- Shared patterns live under `skills/patterns/references/patterns/**`.14- Installable shared skills live under `skills/**`.15- Workflows used only by this repository live under `.agents/skills/**`.16- Root routing or publication policy lives in `AGENTS.md` and `README.md`.1718Do not edit installed `~/.agents/skills/**` copies, a consuming repository's19`{root}/llm-wiki/**` tree, or any vendor subtree. Preserve unrelated local WIP.2021## Prepare the change22231. Read the current remote `main` SHA through the GitHub connector. If the24 normal checkout contains unrelated changes or unresolved state, prepare the25 requested patch in a clean isolated checkout of that exact SHA. Never stash,26 reset, discard, resolve, or commit unrelated work.272. From that verified checkout, read root `AGENTS.md`, the affected skill28 entrypoint, and every directly linked instruction needed for the requested29 change. Dirty or unpublished guidance does not define the patch.303. For a shared pattern change, read31 `skills/patterns/references/patterns/README.md` and search32 `skills/patterns/references/patterns/index.md` before editing. Ground the33 pattern in a real example when one exists, update the pattern index in the34 same pass, and keep repository-specific guidance out of the shared skill.354. For a skill change, load `$skill-creator`, preserve supported metadata, and36 update direct routing references when a name, path, or responsibility moves.375. For a skill rename, require explicit old and new names; do not infer either38 from dirty WIP. Search every tracked file at the verified base SHA, and retain39 the old name only in reviewed migration code, tests, or documentation.40 Inspect installers, lock metadata, managed markers, and generated-install41 behavior. Install and validate the new skill, migrate and validate every42 requested repository marker, and only then remove a same-source legacy43 installation. Preserve the legacy installation if any marker migration44 fails, and refuse to remove an installation owned by another source.456. Make only the coherent requested pattern and skill changes. Keep pattern46 sources, skill entrypoints, metadata, scripts, tests, indexes, and direct47 documentation references consistent when the requested change affects them.4849## Validate50511. Inspect the exact diff and run `git diff --check`.522. Run the Codex skill validator on every added, renamed, or materially changed53 skill directory.543. Check changed relative links and verify that removed names or paths have no55 stale callers beyond deliberate migration code, tests, or documentation.564. Run targeted tests for every changed script. If no Nx target exists, invoke57 the script's native test runner directly.585. Re-read remote `main`. If it moved during preparation, rebuild the patch on59 the new head and repeat validation.6061## Publish through a pull request6263Treat “via PR”, “open a PR”, or “publish” as authorization to create the topic64branch, publication commit, and pull request. It does not authorize merge.65661. Use `chatgpt-codex-connector` for every GitHub mutation. Do not use a67 personal-account Git push or `gh`.682. Create a non-`main` `<type>/<kebab-topic>` branch from the exact verified69 remote `main` SHA. Use a Conventional Commit type prefix (`feat`, `fix`,70 `docs`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`) and71 a short kebab-case slug. Prefer the prefix that matches the publication72 commit's conventional type — for example `docs(patterns): …` on branch73 `docs/inline-one-call-simple-helpers`. Do not use `codex/` prefixes.743. Stage the coherent patch in the isolated checkout and record its exact75 `git write-tree` SHA. Create the required blobs and tree from the verified76 base tree, then require the connector-created tree SHA to equal the recorded77 local tree SHA before creating one coherent conventional commit and78 fast-forwarding the topic ref without force.794. Open a ready pull request against `morgs32/llm-wiki:main`. Include the80 behavioral split, migration details, and local validation in the body.815. Verify the pull request head SHA and exact changed-file list. Wait for the82 `validate-skills` check and Codex review on that head; address in-scope83 findings with connector-authored commits and revalidate the latest head.846. Stop with the pull request open unless the user separately authorizes merge85 or auto-merge. Follow root `AGENTS.md` for merge eligibility and gates; never86 bypass branch protection.8788Report the pull request URL, branch and head SHA, exact source areas changed,89and validation results. Do not refresh installed skills or downstream guidance90from an unmerged pull request.