Skip to content

release: v0.1.0 - #11

Merged
doulos76 merged 15 commits into
mainfrom
release/0.1.0
Aug 21, 2026
Merged

release: v0.1.0#11
doulos76 merged 15 commits into
mainfrom
release/0.1.0

Conversation

@doulos76

Copy link
Copy Markdown
Owner

Summary

First tagged release. Brings main up to date with everything built on develop since the initial commit:

  • Initial EDE skill implementation (SKILL.md, PRD.md, references/, tests/scenarios.md)
  • Full 8-scenario behavioral test suite run (with-skill vs. baseline) recorded under tests/results/
  • Installation docs for Claude Code, Claude.ai, and Codex
  • Git Flow adoption (CONTRIBUTING.md with diagrams) and branch protection on main/develop
  • GitHub Actions CI (SKILL.md validation, link checking, .skill packaging verification, test-record reminder)
  • Issue/PR templates, public repo metadata (description, topics)
  • Finalized CHANGELOG.md for this release

Test plan

  • scripts/validate_skill.py passes locally
  • CI passes on this PR
  • After merge: tag main as v0.1.0 and merge back into develop

🤖 Generated with Claude Code

doulos76 and others added 15 commits August 21, 2026 19:32
Document main/develop/feature/release/hotfix conventions now that
this repo uses Git Flow, plus the expectation that SKILL.md changes
get a behavioral test run recorded under tests/results/.
docs: add CONTRIBUTING.md with Git Flow branching rules
Completes the full 8-scenario suite in tests/scenarios.md. Like the
first run (A, B, D, E, G), all 3 scenarios passed under both
with-skill and baseline conditions. Combined with the first run,
8/8 scenarios are currently non-discriminating for Sonnet 5 baseline
behavior. Recommend treating the suite as a regression guard rather
than an active discriminating eval at this model tier, and suggest
next steps (weaker model, harder adversarial scenarios, or focusing
comparison on response structure) if discriminating evidence is
needed later.
test: record behavioral run for scenarios C, F, H
- Repository Status: v0.1.0 is implemented and published, not a draft;
  point to the behavioral test results.
- Repository structure: add CONTRIBUTING.md and tests/results/.
- Add Installation section covering Claude Code (~/.claude/skills/)
  and Claude.ai (.skill packaging via skill-creator), alongside the
  existing Codex instructions.
- Add Behavioral Testing section summarizing the 8-scenario suite and
  its current regression-guard status, linking to tests/results/.
- Add Contributing section linking to CONTRIBUTING.md's Git Flow
  conventions.
Bug report and feature/content request issue templates, plus a PR
template that reminds contributors which base branch to target
(develop vs. main, per CONTRIBUTING.md) and to record a behavioral
test run when SKILL.md changes.
docs: update README to reflect current repo state
docs: add issue and PR templates for open-source contributors
Add a gitGraph showing the branch/tag lifecycle (feature -> develop,
release/hotfix -> main -> tag -> synced back to develop) and a
flowchart summarizing which branch each workflow targets. GitHub
renders mermaid fences natively, so these show as diagrams directly
on the CONTRIBUTING.md page.
docs: add mermaid diagrams to CONTRIBUTING.md
Use explicit branch order (main, release/hotfix, develop, feature)
so the diagram lays out as four parallel horizontal lanes, matching
the conventional GitFlow diagram, instead of interleaving branches
in commit order. Add the base-branch flowchart directly under the
gitGraph as well, alongside the existing copy under Workflow.
docs: switch gitGraph to standard 4-lane GitFlow layout
Adds .github/workflows/ci.yml with four jobs, run on PRs and pushes
to main/develop:

- validate-skill: checks SKILL.md's YAML frontmatter is well-formed
  and has non-empty name/description fields matching the repo name
  (scripts/validate_skill.py). Fails the build on error.
- link-check: checks markdown files for broken relative/absolute
  links (gaurav-nelson/github-action-markdown-link-check). Fails the
  build on error.
- package-skill: packages SKILL.md + references/ + tests/ into a
  .skill zip using a new self-contained scripts/package_skill.py
  (no external dependency on the skill-creator repo) and confirms
  the archive was produced. Fails the build on error.
- skill-change-test-record: on PRs, warns (non-fatal, via
  scripts/check_test_record.py) if SKILL.md changed but no new file
  was added under tests/results/, per the CONTRIBUTING.md rule for
  non-trivial skill content changes.

All three scripts were run locally against this repo's current state
to confirm expected pass/warn behavior before wiring them into CI.
ci: add GitHub Actions for SKILL.md validation, links, and packaging
Finalize the changelog for the first tagged release: the initial EDE
skill implementation, the full behavioral test suite run, Git Flow
adoption with branch protection, GitHub Actions CI, and public
open-source setup (templates, README, license).
@doulos76 doulos76 added documentation Improvements or additions to documentation enhancement New feature or request labels Aug 21, 2026
@doulos76
doulos76 merged commit 5cd0b9a into main Aug 21, 2026
4 checks passed
@doulos76
doulos76 deleted the release/0.1.0 branch August 21, 2026 11:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant