zning1994/brainharness-docs
v1.2.1MIT
Organize project documentation by size, audience, and freshness. Slim bloated CLAUDE.md/AGENTS.md and decide where docs should live.
Changelog
All notable changes to the docs-organization skill will be documented in this file.
Format follows Keep a Changelog.
[1.2.1] - 2026-10-04
Changed
- Add a portable OpenAI plugin manifest alongside the Claude manifest.
- Keep skill instructions shared and make bundled resources reachable from the skill directory.
- Document installation scope and public ChatGPT listing status.
[1.2.0] - 2026-10-04
Changed
- Rename
docs-organizationtobrainharness-docsand align repository links and installation names with BrainHarness. - Update distribution metadata and documentation; preserve skill behavior and historical release notes.
[1.1.0] - 2026-04-08
Added
- Step 0: Root-level noise audit — clean non-doc clutter before restructuring
- Multi-Repo / Monorepo Workspace template with umbrella vs repo-specific doc rules
- Migration checklist: snapshot before/after counts (steps 1, 14)
- Migration checklist: check implicit references before moving files (steps 6, 8)
- Anti-pattern: flat
archive/dumping ground
Changed
- Trimmed
descriptionfrontmatter for conciseness (~500 → ~350 chars) - Migration checklist expanded from 9 to 14 steps with more actionable detail
- Recommend
rg(ripgrep) overgrep -rfor reference checks
[1.0.0] - 2026-04-06
Added
- Initial release
- Project size assessment (small / medium / large)
- Directory templates for each project size
- Core principles: single source of truth, CLAUDE.md as instruction manual, organize by audience + freshness, no cross-doc mirroring
- Document metadata convention (status / audience / last_reviewed)
- Anti-patterns table
- Migration checklist (9 steps)
- CLAUDE.md doc index example