Skip to content
This repository was archived by the owner on Aug 10, 2026. It is now read-only.

Commit 88623ab

Browse files
sleegmesleegme
committed
feat: release design-workflow v0.2.0
1 parent 2342236 commit 88623ab

52 files changed

Lines changed: 2494 additions & 1319 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.gitattributes‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
* text=auto
2+
*.md text eol=lf
3+
*.json text eol=lf
4+
*.py text eol=lf
5+
*.yml text eol=lf
6+
*.yaml text eol=lf

‎.github/workflows/ci.yml‎

Lines changed: 44 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,17 +7,55 @@ on:
77
permissions:
88
contents: read
99

10+
concurrency:
11+
group: ci-${{ github.workflow }}-${{ github.ref }}
12+
cancel-in-progress: true
13+
1014
jobs:
1115
validate:
16+
name: Python ${{ matrix.python-version }}
17+
runs-on: ubuntu-latest
18+
timeout-minutes: 10
19+
strategy:
20+
fail-fast: false
21+
matrix:
22+
python-version: ["3.11", "3.12", "3.13"]
23+
steps:
24+
- uses: actions/checkout@v4
25+
- uses: actions/setup-python@v5
26+
with:
27+
python-version: ${{ matrix.python-version }}
28+
cache: pip
29+
- name: Install validation dependency
30+
run: python -m pip install -r requirements-dev.txt
31+
- name: Compile Python sources
32+
run: python -m compileall -q design-workflow/scripts scripts tests
33+
- name: Validate project invariants
34+
run: python scripts/validate_project.py
35+
- name: Validate official Agent Skills format
36+
run: agentskills validate design-workflow
37+
- name: Run unit tests
38+
run: python -m unittest discover -s tests -v
39+
40+
package:
41+
name: Verify release archive
42+
needs: validate
1243
runs-on: ubuntu-latest
44+
timeout-minutes: 10
1345
steps:
1446
- uses: actions/checkout@v4
1547
- uses: actions/setup-python@v5
1648
with:
1749
python-version: "3.12"
18-
- name: Compile validation scripts
19-
run: python -m compileall -q scripts
20-
- name: Validate Agent Skill package
21-
run: python scripts/validate_skill.py .
22-
- name: Validate routing test matrix
23-
run: python scripts/test_routing_cases.py
50+
- name: Build deterministic archive twice
51+
run: |
52+
python scripts/package_skill.py --version 0.2.0 --output-dir dist-a
53+
python scripts/package_skill.py --version 0.2.0 --output-dir dist-b
54+
cmp dist-a/design-workflow-0.2.0.zip dist-b/design-workflow-0.2.0.zip
55+
- uses: actions/upload-artifact@v4
56+
with:
57+
name: design-workflow-ci-package
58+
path: |
59+
dist-a/design-workflow-0.2.0.zip
60+
dist-a/design-workflow-0.2.0.zip.sha256
61+
if-no-files-found: error

‎.github/workflows/release.yml‎

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
name: Release
2+
3+
on:
4+
push:
5+
tags:
6+
- "v[0-9]+.[0-9]+.[0-9]+"
7+
8+
permissions:
9+
contents: write
10+
11+
jobs:
12+
release:
13+
runs-on: ubuntu-latest
14+
timeout-minutes: 15
15+
steps:
16+
- uses: actions/checkout@v4
17+
- uses: actions/setup-python@v5
18+
with:
19+
python-version: "3.12"
20+
cache: pip
21+
- name: Install validation dependency
22+
run: python -m pip install -r requirements-dev.txt
23+
- name: Validate project and skill
24+
run: |
25+
python scripts/validate_project.py
26+
agentskills validate design-workflow
27+
python -m unittest discover -s tests -v
28+
- name: Build release archive
29+
run: python scripts/package_skill.py --version "$GITHUB_REF_NAME"
30+
- name: Create verified GitHub Release
31+
env:
32+
GH_TOKEN: ${{ github.token }}
33+
run: >-
34+
gh release create "$GITHUB_REF_NAME"
35+
dist/design-workflow-*.zip
36+
dist/design-workflow-*.zip.sha256
37+
--verify-tag
38+
--generate-notes
39+
--title "design-workflow $GITHUB_REF_NAME"

‎.gitignore‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
11
__pycache__/
22
*.py[cod]
33
.DS_Store
4+
.venv/
5+
.tooling/
6+
dist/
7+
dist-*/
8+
*.zip
9+
*.zip.sha256

‎CHANGELOG.md‎

Lines changed: 29 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,35 @@
11
# Changelog
22

3-
All notable changes to this project are documented here.
3+
All notable changes are documented here.
44

5-
## [0.1.0] - 2026-07-16
5+
## [0.2.0] - 2026-07-17
66

77
### Added
88

9-
- medium-neutral `design-workflow` Agent Skill
10-
- explicit preservation versus redesign boundary
11-
- routing for preserve, expand, create, redesign, critique, brand-check,
12-
translate, and profile tasks
13-
- progressive reference files and design-profile templates
14-
- realistic routing and trigger evaluation cases
15-
- dependency-free validation scripts
16-
- Apache-2.0 license, source audit, and third-party notices
17-
- GitHub Actions CI
18-
- public release checklist and contributor/security documentation
19-
20-
### Removed from the distributable package
21-
22-
- project-specific names, palettes, layouts, products, and organizational context
23-
- internal routing identifiers not required by the Agent Skills standard
24-
- unverified Canva attribution
9+
- installable `design-workflow/` package whose directory matches the skill name
10+
- generated `agents/openai.yaml` interface metadata
11+
- mixed-route, partial-evidence, and instruction-security guidance
12+
- dependency-free route-contract validator and example contract
13+
- balanced trigger cases and a client-gradeable semantic smoke suite
14+
- recorded independent 16-case forward test covering all eight routes
15+
- project validator, unit tests, deterministic skill/project ZIP packaging, and SHA-256 output
16+
- CI with official `agentskills` validation and tagged GitHub Release automation
17+
18+
### Changed
19+
20+
- clarified `expand` versus `translate` and dimension-specific preservation
21+
- narrowed activation to tasks that require visual design judgment
22+
- separated human repository documentation and evals from the runtime skill
23+
- replaced committed self-reported dry-run results with a reproducible grading
24+
protocol
25+
26+
### Removed
27+
28+
- root-level `SKILL.md` layout that produced an invalid default installation name
29+
- unrelated runtime traceback from the old routing report
30+
- CI claims that fixture consistency was semantic model validation
31+
32+
## [0.1.0] - 2026-07-16
33+
34+
- initial medium-neutral routing skill with eight routes
35+
- preservation-versus-redesign boundary, references, templates, and provenance

‎CONTRIBUTING.md‎

Lines changed: 21 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,32 @@
11
# Contributing
22

3-
Contributions should improve reusable design-routing behavior rather than add a
4-
specific project's visual rules.
3+
Keep the runtime skill focused on intent routing and change boundaries. Put human
4+
documentation, release notes, tests, and evaluation results at the repository
5+
root, not inside `design-workflow/`.
56

67
## Requirements
78

8-
- Keep `SKILL.md` concise and route-focused.
9-
- Put conditional detail in one-level `references/` files.
10-
- Add or update realistic cases for every routing change.
119
- Preserve the default rule: existing design is not redesign authorization.
12-
- Do not add company, product, campaign, palette, or private workflow context.
13-
- Audit every copied or adapted source before inclusion.
14-
- Keep scripts dependency-free unless a dependency is clearly justified.
10+
- Keep `design-workflow/SKILL.md` concise and imperative.
11+
- Link route-specific references directly from `SKILL.md`.
12+
- Add realistic route and trigger cases for every behavior change.
13+
- Treat recorded semantic results as evidence only when they come from a fresh
14+
client run.
15+
- Keep runtime scripts dependency-free.
16+
- Retain license, notice, and modification-attribution files.
17+
- Do not add private project context, secrets, proprietary assets, or fabricated
18+
benchmark results.
1519

16-
## Validation
20+
## Verification
1721

1822
```bash
19-
python scripts/validate_skill.py .
20-
python scripts/test_routing_cases.py
23+
python -m pip install -r requirements-dev.txt
24+
python scripts/validate_project.py
25+
agentskills validate design-workflow
26+
python -m unittest discover -s tests -v
27+
python scripts/package_skill.py --version 0.2.0
28+
python scripts/package_project.py --version 0.2.0
2129
```
2230

23-
Run the checks before opening a pull request.
31+
Open a pull request only after all commands pass and any changed semantic
32+
behavior has a fresh forward-test result.

0 commit comments

Comments
 (0)