CLAUDE.md · diff
git:20260326.2ad578c to git:20260326.aa28655
5 added, 68 removed. Audit A to A.
- # Freenet Agent Skills - Version Information
-
- **Current Version:** 1.0.10
-
- ## Version History
-
- ### 1.0.10 (2026-03-26)
- - Merged local-node skill content into local-dev: HTTP endpoints, dashboard scraping, WebSocket API protocol details, NodeDiagnostics config, config.toml reference, ring distance formula, fdev query/diagnostics commands
-
- ### 1.0.9 (2026-03-26)
- - Updated release skill: River smoke test step, tmux tab naming, release.sh enforcement, matrix-commander Markdown fix, merge queue optimization docs
- - Updated pr-creation skill: added Claude Rule Review handling
- - Fixed phantom fdev commands in dapp-builder skill
- - Added issue assignment checks to prevent duplicate work
-
- ### 1.0.8 (2026-03-08)
- - Added local-dev skill for local node management and dApp iteration (`/freenet:local-dev`)
-
- ### 1.0.7 (2026-02-26)
- - Added linux-test skill: runs integration tests requiring Linux loopback range via Docker (`/freenet:linux-test`)
- - Uses existing `docker/test-runner/` infrastructure for containerized test execution
- - Includes known test mapping for macOS-incompatible tests (connectivity, blocked peers, delegate messaging)
-
- ### 1.0.6 (2026-02-25)
- - Added 5 recurring bug-prevention patterns (from Feb 2025 fix review of 25 bugs) to review agents and skills
- - Updated skeptical-reviewer: added Freenet-specific bug patterns section (select! fairness, fire-and-forget, state cleanup, backoff/jitter, deployment)
- - Updated testing-reviewer: added test gap checklist for the 5 patterns
- - Updated pr-review skill: added 5-pattern checklist to skeptical review step
- - Updated pr-creation skill: added bug-prevention patterns section and checklist item
- - Based on freenet-core#3271 analysis
-
- ### 1.0.5 (2026-02-22)
- - Updated release skill: gateways are now updated immediately after cross-compile binaries are available (no 10-min polling delay)
- - Removed --deploy-local and --deploy-remote flags (gateway updates are now automatic)
- - Added incident learning: version mismatch when users install before gateways update
-
- ### 1.0.4 (2026-02-20)
- - Updated release skill with universal content from local nova skill: error recovery, rollback, cross-compile binary waiting, incident learnings, common issues
- - Removed nova-specific SSH commands from plugin release skill (those stay in local freenet-release skill)
-
- ### 1.0.3 (2026-02-20)
- - Updated systematic-debugging: added 6 recurring bug patterns to hypothesis phase (silent failures, resource exhaustion, incomplete wiring, TTL races, safe-change regressions, mock divergence)
- - Updated pr-creation: CI gap tests must be in same PR, simulation health metrics required not suggested, added wiring completeness and resource invariant sections
- - Based on CI gap analysis from freenet-core#3141
-
- ### 1.0.2
- - Added release skill
-
- ### 1.0.1 (2026-02-14)
- - Added claude.md for version tracking
- - Established version update workflow
-
- ### 1.0.0 (Initial Release)
- - dapp-builder skill for building Freenet applications
- - pr-creation skill for Freenet PR guidelines
- - systematic-debugging skill for debugging methodology
- - pr-review skill
- - Claude Code hooks for cargo fmt and clippy
- - Git pre-commit hooks
+ # Freenet Agent Skills
## Updating the Version
When making changes to the plugin:
1. **Update marketplace.json**: Increment the version in `.claude-plugin/marketplace.json` → `metadata.version`
- 2. **Update claude.md**: Add entry to version history with date and changes
+ 2. **Update CHANGELOG.md**: Add entry at the top with date and changes
3. **Commit both files**: Ensure both files are committed together
+ CI will fail if skills/agents/hooks are changed without a version bump in `marketplace.json`.
+
### Version Numbering
Follow semantic versioning (MAJOR.MINOR.PATCH):
- **MAJOR**: Breaking changes to skill structure or API
- **MINOR**: New skills or significant feature additions
- **PATCH**: Bug fixes, documentation updates, minor improvements
- ## Encoding
-
- This file serves as the canonical version reference and should be updated every time:
- - New skills are added
- - Existing skills are modified
- - Documentation is significantly updated
- - Hooks are changed
- - Agent definitions are modified
+ See [CHANGELOG.md](CHANGELOG.md) for full version history.