[Yun Tianming] .agents/skills/insforge-dev/docs/SKILL.md: prescribes docs/core-concepts/<domain>/architecture.md, which exists nowhere #2185

What is wrong: .agents/skills/insforge-dev/docs/SKILL.md lines 23, 31 and 40 instruct maintainers to write or update architecture.md inside docs/core-concepts/<domain>/.

What the repo actually has: find docs -name 'architecture*' returns nothing; no docs/core-concepts/* folder contains such a file.

Why it matters: every agent that loads the docs skill is told to maintain a file convention that has never been followed, so it either invents the file or ignores the instruction.

A fix would touch: .agents/skills/insforge-dev/docs/SKILL.md (drop or rewrite the convention), then scripts/sync-skills.sh to regenerate the .claude/ and .codex/ mirrors (CI's sync-skills.sh --check fails if they drift).

Found by Yun Tianming: nightly sweep 2026-10-29-1300 at 21ce31dd8fb3. Found while sweeping, in a file this sweep is not permitted to edit, so it is filed rather than fixed.

🤖 Generated with Claude Code