Skip to content

Commit b797f83

Browse files
committed
chore: Bump version to 0.3.0
## Summary Version 0.3.0 includes slash command enhancements, comprehensive bug fixes, and refactoring improvements. ## Key Changes ✨ Features: - Enhanced slash command specification with Claude Code best practices - Added argument-hint, allowed-tools, model fields - Added positional arguments support ($1, $2, $3) 🐛 Bug Fixes: - Removed all MCP-specific examples (30→0) - Eliminated redundant examples (8→3, 62.5% reduction) - Removed hardcoded line number references ♻️ Refactoring: - Removed redundant Argument Access descriptions ## Files Updated - pyproject.toml (0.2.0 → 0.3.0) - src/metaspec/__init__.py (0.2.0 → 0.3.0) - CHANGELOG.md (Unreleased → 0.3.0)
1 parent a27782b commit b797f83

File tree

3 files changed

+44
-44
lines changed

3 files changed

+44
-44
lines changed

CHANGELOG.md

Lines changed: 42 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
77

88
## [Unreleased]
99

10-
### ✨ Improvements
10+
---
11+
12+
## [0.3.0] - 2025-11-07
13+
14+
### ✨ Features
1115

1216
**Enhanced slash command specification with Claude Code best practices**
1317

@@ -61,27 +65,6 @@ model: claude-3-5-sonnet-20241022
6165

6266
### 🐛 Bug Fixes
6367

64-
**Removed hardcoded line number references**
65-
66-
**Issue**: Document contained hardcoded line references that become stale after edits:
67-
- ❌ "(lines 364-643)" - specific line ranges in cross-references
68-
- ❌ Line numbers shift when content is added/removed
69-
- ❌ Creates maintenance burden and confusion
70-
71-
**Fix**: Removed all hardcoded line numbers (2 occurrences):
72-
- ✅ Line 855: Removed "(lines 364-643)" from Component 3 cross-reference
73-
- ✅ Line 867: Removed "(lines 364-643)" from Component 3 subset reference
74-
- ✅ Kept component name references for clarity
75-
76-
**Impact**:
77-
- ✅ References won't become stale after edits
78-
- ✅ Easier to maintain
79-
- ✅ Still clear (users can search for "Component 3")
80-
81-
**Files Changed**: `specify.md.j2`
82-
83-
---
84-
8568
**Removed all MCP-specific examples to ensure framework neutrality**
8669

8770
**Issue**: Document contained 30+ references to MCP (Model Context Protocol) throughout:
@@ -98,16 +81,6 @@ model: claude-3-5-sonnet-20241022
9881
- ✅ Changed all MCP examples to framework-neutral ones
9982
- ✅ Tables now show: MetaSpec (specify, clarify, plan) and Generic (design, build, test)
10083

101-
**Before**:
102-
- Component 3: 37 lines of MCP-specific CLI design
103-
- Tables: MCP examples dominating (define-server, init-server, validate-server)
104-
- Quick Reference: "Define Server" → define-server
105-
106-
**After**:
107-
- Component 3: Removed
108-
- Tables: MetaSpec + Generic examples only
109-
- Quick Reference: "Specify Feature" → specify
110-
11184
**Impact**:
11285
-**Framework neutral**: No external protocol dependencies
11386
-**Dogfooding emphasized**: Uses MetaSpec's own commands as examples
@@ -146,21 +119,48 @@ model: claude-3-5-sonnet-20241022
146119

147120
---
148121

149-
### 🐛 Bug Fixes
122+
**Removed hardcoded line number references**
123+
124+
**Issue**: Document contained hardcoded line references that become stale after edits:
125+
- ❌ "(lines 364-643)" - specific line ranges in cross-references
126+
- ❌ Line numbers shift when content is added/removed
127+
- ❌ Creates maintenance burden and confusion
128+
129+
**Fix**: Removed all hardcoded line numbers (2 occurrences):
130+
- ✅ Line 855: Removed "(lines 364-643)" from Component 3 cross-reference
131+
- ✅ Line 867: Removed "(lines 364-643)" from Component 3 subset reference
132+
- ✅ Kept component name references for clarity
133+
134+
**Impact**:
135+
- ✅ References won't become stale after edits
136+
- ✅ Easier to maintain
137+
- ✅ Still clear (users can search for "Component 3")
138+
139+
**Files Changed**: `specify.md.j2`
140+
141+
---
142+
143+
### ♻️ Refactoring
144+
145+
**Removed redundant Argument Access descriptions**
150146

151-
**Replaced external project examples with MetaSpec's own implementations**
147+
**Issue**:
148+
- "Argument Access" section repeated 4 times in slash command templates
149+
- Full descriptions duplicated in Template 1, Template 2, and Template 3
150+
- ~10 lines of redundant content
152151

153-
**Issue**: Example 3 used "MCP Server Development" (Anthropic's MCP protocol), making MetaSpec appear project-specific rather than a general framework.
152+
**Fix**: Simplified to single-line references in templates:
153+
- ✅ Kept comprehensive description in Frontmatter Fields section (single source of truth)
154+
- ✅ Template 1: 3 lines → 1 line reference
155+
- ✅ Template 2: 4 lines → 1 line reference
156+
- ✅ Template 3: 3 lines → 1 line reference
154157

155-
**Fix**: Replaced with "MetaSpec SDD Workflow" showing how MetaSpec itself was built (dogfooding):
156-
- Example 3: constitution → specify → clarify → plan → tasks → implement → checklist → analyze
157-
- Table: Added MetaSpec SDD + SDS workflow examples
158-
- Pattern: Development workflow → namespaced commands
158+
**After**: `**Argument Access**: $ARGUMENTS, $1, $2, $3 (see Frontmatter Fields above)`
159159

160160
**Impact**:
161-
-More credible (we use this ourselves)
162-
-Framework-neutral (not tied to external projects)
163-
-Educational (verifiable in MetaSpec source)
161+
-Removed 9 lines of redundancy
162+
-Easier to maintain (single source of truth)
163+
-Users still see relevant variables in templates
164164

165165
**Files Changed**: `specify.md.j2`
166166

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[project]
22
name = "meta-spec"
3-
version = "0.2.0"
3+
version = "0.3.0"
44
description = "Meta-specification framework for generating Spec-Driven X (SD-X) toolkits for AI agents"
55
readme = "README.md"
66
requires-python = ">=3.11"

src/metaspec/__init__.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
from YAML definitions.
66
"""
77

8-
__version__ = "0.2.0"
8+
__version__ = "0.3.0"
99

1010
__all__ = ["__version__"]
1111

0 commit comments

Comments
 (0)