82 lines
4.8 KiB
Markdown
82 lines
4.8 KiB
Markdown
# Changelog
|
|
|
|
All notable changes to this documentation repository, grouped by version and release date.
|
|
Document versions of the individual guideline files are tracked separately in their headers.
|
|
|
|
## 0.4.0 — 2026-08-18
|
|
|
|
### Added
|
|
- Skill versioning: every `SKILL.md` now carries `metadata.version` — `changelog` v2, `check` v1,
|
|
`commit` v2, `documentation` v1, `documentation_context` v2. The skill format has no top-level
|
|
`version` field; `metadata` is one of the six Agent Skills spec fields, so the frontmatter still
|
|
packages and uploads cleanly
|
|
- "Skills" section in `README.md` describing the versioning convention, the install location
|
|
(`~/.claude/skills/`) and the rule that the folder name — not `name:` — is the command
|
|
- The five skills listed individually in the `README.md` structure tree
|
|
- `AGENTS.md` v5 → v6: new "Commit messages" subsection under Git — commits and pull requests must
|
|
never carry AI authorship (`Co-Authored-By`, "Generated with …", tool signatures or emoji footers).
|
|
The subsection also states the single-line verbal English style, so assistants without the `commit`
|
|
skill get the same rules; the AI-authorship rule was added to the skill as well
|
|
- `CHANGELOG.md` for this repository, with history backfilled from the git log
|
|
- Explicit line length for Rust: 100 characters (rustfmt default `max_width`) in both Rust design documents
|
|
- `README.md`, `docs/`, `prebuild.py` and the PyInstaller `.spec` to the template structure in `Python/TEMPLATE.md`
|
|
- Note in `Python/TEMPLATE.md` that `AGENTS.md` and `DESIGN_DOCUMENT.md` are not part of the template
|
|
- `README.md` to the session read list in `Claude/CLAUDE.md`, plus a missing top-level heading
|
|
- `Document Version` marker in `Claude/CLAUDE.md`, starting at v2 — it is copied into projects like
|
|
`AGENTS.md` and the design documents, so it can go stale there the same way
|
|
|
|
### Changed
|
|
- Document versions bumped for the structural changes released on 2026-08-18:
|
|
`DESIGN_DOCUMENT.md` v8 → v9, `DESIGN_DOCUMENT_MODULE.md` v1 → v2,
|
|
`Rust/DESIGN_DOCUMENT.md` v1 → v2, `Rust/DESIGN_DOCUMENT_LIB.md` v1 → v2,
|
|
`DESIGN_DOCUMENT_GODOT.md` v1 → v2
|
|
- `Project template/CHANGELOG.md` now names the project manifest generically
|
|
(`pyproject.toml`, `Cargo.toml`, `project.godot`) instead of `pyproject.toml` only
|
|
- Godot debug constant renamed `Constants.DEBUG` → `Constants.DEFAULT_DEBUG`, matching the Python reference module
|
|
- `README.md` step 1 of "Starting a new project" now also requires writing a `README.md`
|
|
- `Python/TEMPLATE.md` entry point is named by purpose or tool name instead of `main.py`
|
|
- `prebuild.py` loads `.env` before importing `src.constants` instead of relying on the import side effect
|
|
|
|
### Fixed
|
|
- Skill folder `Claude/skills/context/` renamed to `documentation_context/`, with the frontmatter
|
|
`name` matched to it. The folder name is what Claude Code turns into the command, so the old
|
|
mismatch meant installing from this repository would have changed `/documentation_context`
|
|
into `/context`
|
|
- Removed the misplaced lock-file rule from the Testing sections of `DESIGN_DOCUMENT_MODULE.md` (§9)
|
|
and `Rust/DESIGN_DOCUMENT_LIB.md` (§8) — it already belongs to the Poetry / Distribution sections
|
|
|
|
## 0.3.0 — 2026-08-18
|
|
|
|
### Added
|
|
- `Zscaler/ZSCALER_CERTIFICATE.md` — full certificate setup for Node, Python, git and cargo
|
|
- Language-specific `.gitignore` files for Python, Rust and Godot, plus a shared core in `Project template/`
|
|
- `poetry.lock` and `prebuild.py` sections in `Python/DESIGN_DOCUMENT.md`
|
|
|
|
### Changed
|
|
- Unified task notation across all languages on the Todo Tree tags `TODO`, `FIXME`, `BUG`, `HACK`, `NOTE`
|
|
- `AGENTS.md` v4 → v5: rewritten as strictly language-agnostic, naming no concrete tool
|
|
- Python line length 150 → 120 characters
|
|
- Rust edition 2021 → 2024 (requires Rust 1.85 or newer)
|
|
- Godot project version key corrected to `application/config/version`
|
|
- Every design document now lists `README.md` among the core root documents
|
|
|
|
### Removed
|
|
- `Zscaler/NODE_EXTRA_CA_CERTS.md`, superseded by `ZSCALER_CERTIFICATE.md`
|
|
|
|
## 0.2.0 — 2026-06-24
|
|
|
|
### Added
|
|
- `Godot/DESIGN_DOCUMENT_GODOT.md` — Godot development guidelines (v1)
|
|
|
|
## 0.1.0 — 2026-05-25
|
|
|
|
### Added
|
|
- `Rust/DESIGN_DOCUMENT.md` and `Rust/DESIGN_DOCUMENT_LIB.md` — Rust guidelines for applications and libraries (v1)
|
|
- `Claude/` — `CLAUDE.md`, `AGENTS.md` (v4) and the custom skills `changelog`, `check`, `commit`, `context`, `documentation`
|
|
- `Python/` — `DESIGN_DOCUMENT.md` (v8), `DESIGN_DOCUMENT_MODULE.md` (v1), `TEMPLATE.md`, and the reference `constants.py` module with tests
|
|
- `Project template/` — `PROJECT.md` and `CHANGELOG.md` templates
|
|
|
|
### Changed
|
|
- Documentation organised into topic folders: `Claude/`, `Python/`, `Zscaler/`, `Project template/`
|
|
- `README.md` rewritten to describe the repository itself instead of a single project
|