Commit e336618
feat: trim project to prompts-only deliverable (#31)
* refactor: trim project to prompts-only deliverable
Removes Python server implementation, tests, and tooling to focus on the core
spec-driven development prompts. Project now provides lightweight, markdown-based
prompts that work with any AI assistant, removing MCP server dependencies.
- Delete mcp_server/ module and server.py implementation
- Remove slash_commands CLI tooling and generators
- Delete all pytest test files and test configuration
- Remove pyproject.toml and uv dependency management
- Simplify CI workflows to pre-commit-only checks
- Add semantic release configuration (.releaserc.toml)
- Update CONTRIBUTING.md and README.md to reflect prompt-focused approach
- Retain core prompts: generate-spec, generate-task-list-from-spec, manage-tasks, validate-spec-implementation
🤖 Generated with Claude Code
Co-Authored-By: Claude <[email protected]>
* feat(docs): add local playbook site with Liatrio brand styling
Recreate the SDD Playbook website locally with dark theme matching
dev.liatrio.com. Includes:
- HTML structure with all playbook content sections
- CSS styling using Liatrio brand colors and DM Sans typography
- Dark theme with texture background on reactive-art section
- Responsive design for mobile/tablet/desktop
- Logo and texture image assets
The site can be viewed locally or deployed to GitHub Pages.
* feat(docs): add developer experience, common questions, and video overview pages
Add three new pages to the playbook site recreating content from
Gamma.app reference site:
- developer-experience.html: AI-assisted workflow case study with
before/after scenarios, metrics, and workflow demonstrations
- common-questions.html: Evidence-based FAQ addressing SDD objections
with proof artifacts and real-world examples
- video-overview.html: Video embed page with Google Drive integration
All pages use consistent Liatrio brand styling with dark theme,
responsive design, and proper navigation integration. Includes
extensive CSS additions for new page-specific components including
code examples, metric boxes, workflow items, and video embeds.
* feat(docs): add reference materials page with 9 SDD workflow examples
Add reference-materials.html page that showcases complete Spec-Driven
Development workflow documentation. Includes:
- Reference materials landing page with organized grid layout
- 9 complete reference HTML files copied from cspell example:
* AI conversation documentation
* Specification document
* Tasks overview
* Task 01-04 proofs
* Validation report
* Git log analysis
All reference files are stored in references/ directory and linked from
the main reference-materials page. Page uses consistent Liatrio brand
styling with dark theme, responsive grid layout, and hover effects.
Updated navigation links across all pages to point to reference-materials.html
instead of anchor links.
* fix(docs): update validation dates to 2025-11-07 and remove unused index.html
- Update all validation dates from 2025-01-27 to 2025-11-07 in:
* VALIDATION_REPORT-dark.html (2 occurrences)
* ai-conversation file (2 occurrences)
- Remove references/index.html as it's unused and has broken links
pointing to non-existent html-versions/ directory
* feat(docs): add navigation header to all reference pages
Add consistent navigation bar to all 9 reference HTML files that allows
users to navigate back to the main playbook site. Navigation includes:
- Sticky header with dark theme matching playbook site
- Link back to main SDD Playbook index page
- Link to Reference Materials page
- Link to Main Site
- Responsive design for mobile devices
All reference pages now have consistent navigation that matches the
playbook site's styling and branding.
* fix(docs): add missing subtasks to tasks-pre-commit-cspell HTML page
Add all missing subtasks (1.1-1.10, 2.1-2.8, 3.1-3.8, 4.1-4.8) from the
original markdown file to the HTML version. Subtasks are styled consistently
with existing task list styling using checkbox labels and nested list items.
All subtasks match the original markdown file structure and maintain the
dark theme styling with proper code formatting.
* fix(docs): improve inline code styling in task list subtasks
Change task list label layout from flexbox to block with absolute positioned
checkboxes to fix inline code wrapping issues. This allows code elements
within subtask labels to wrap naturally and display properly.
- Changed labels from flex to block layout
- Positioned checkboxes absolutely to left side
- Added proper padding for checkbox spacing
- Improved code element styling within task lists
- Code elements now wrap properly instead of breaking layout
* docs: add comprehensive audit report and fix minor issues
Add detailed audit report documenting:
- Critical font rendering issues (needs investigation)
- High priority DRY violations (navigation/footer duplication)
- Medium priority issues (outdated comments, CSS consolidation)
- Link verification results
Fixes applied:
- Remove outdated comments from video-overview.html
- Consolidate letter-spacing values into CSS variables
- Add text-rendering optimizations for better font display
- Add white-space: nowrap to navigation links to prevent wrapping
* refactor: extract navigation and footer into reusable JS components
- Create navigation.js component to inject navigation dynamically
- Create footer.js component to inject footer dynamically
- Update all 5 main HTML pages to use components
- Remove 'Made with GAMMA' footer text
- Replace footer with Liatrio footer (copyright, Privacy Policy, Terms of Service)
- Add favicon from dev.liatrio.com to all pages
- Update footer CSS to match dev.liatrio.com styling
- Fix navigation to handle relative paths for reference pages
- Add responsive footer styles for mobile
This eliminates ~210 lines of duplicated navigation HTML and ~25 lines
of duplicated footer HTML across all pages, significantly improving
maintainability.
* style(playbook-site): align design with dev.liatrio.com brand standards
Update playbook site styling to match dev.liatrio.com brand guidelines:
- Update accent green color from #a6ef39 to #89df00 (brand standard)
- Reduce H1 font sizes to align with brand typography guidelines
- Convert all ALL CAPS headings to title case for consistency
- Restructure Four Phases section to card-based grid layout
- Add hero-subtitle styling
- Remove uppercase transform from metric labels
- Update all rgba color values to use new accent color
- Add responsive styles for new card layout
* feat(playbook-site): enhance design and add comparison page
- Update logo to reverse/preferred version from dev.liatrio.com
- Reframe content from 'phases' to 'steps' emphasizing prompts
- Add new comparison page comparing SDD prompts to other tools
- Improve visual variety with icons, cards, and alternating backgrounds
- Enhance code element styling with green accent colors
- Add icons to reference materials cards
- Improve reference card link positioning with flexbox
- Add visual distinction to common-questions and developer-experience pages
- Update navigation to link logo to liatrio.com
- Add Liatrio branding throughout site content
* fix(playbook-site): address code review feedback for security and accessibility
- Add rel="noopener noreferrer" to external links in reference-materials.html
- Add aria-hidden="true" to decorative SVG icons in common-questions.html and reference-materials.html
- Add title and loading="lazy" attributes to iframe in video-overview.html
- Remove broken Terms of Service link from footer.js
- Fix .releaserc.toml inline table syntax for python-semantic-release v10 compatibility
* chore: remove more obsolete files
* refactor(docs): move playbook site to docs root and embed fonts
- Move all files from docs/playbook-site/ to docs/ directory
- Embed DM Sans fonts locally (18 font variants)
- Remove GitHub Actions workflow (use standard /docs folder deployment)
- Update .gitignore to commit embedded font files
- Update documentation for new structure
This simplifies deployment by using GitHub Pages standard /docs folder
option instead of custom workflow, since fonts are now pre-embedded.
* style(docs): add hero divider to reduce empty space on reference-materials page
Add a subtle horizontal divider at the bottom of the hero section on the
reference-materials page to visually separate content and reduce the
appearance of empty space. Also reduced hero padding and content margin
for better spacing balance.
* chore(repo): add CODEOWNERS and Code of Conduct, enhance pre-commit hooks
Add repository compliance files and update configuration to align with
template standards:
- Add .github/CODEOWNERS for code ownership assignment
- Add CODE_OF_CONDUCT.md with Contributor Covenant 2.1
- Update .pre-commit-config.yaml with additional hooks:
- check-toml for TOML file validation
- check-added-large-files to prevent large file commits
- gitleaks for secret scanning
- Update CONTRIBUTING.md to reference actual Code of Conduct file
* chore(docs): remove temporary files and update comparison page
Remove temporary audit report and obsolete documentation files:
- Delete audit-report.md (temporary audit report)
- Delete docs/GITHUB_PAGES_COMPATIBILITY.md and related files
- Delete docs/playbook-site/ files (GITHUB_PAGES_COMPATIBILITY.md,
README.md, embed-fonts.py)
- Delete docs/embed-fonts.py and docs/README.md
Also update docs/comparison.html to add link to installation
instructions.
* fix: update install instructions
* docs: update README with comprehensive SDD workflow documentation
Updated README.md to reflect the complete Spec-Driven Development workflow with:
- New directory structure: docs/specs/[NN]-spec-[feature-name]/
- Three-phase task generation process with parent task review
- Proof artifacts structure and creation requirements
- Enhanced four-stage workflow including validation stage with auto-discovery
- Validation gates and coverage matrix details
- Links to comprehensive SDD Playbook documentation
- Updated mermaid diagram showing all workflow phases and interactions
- Clarified checkpoint modes and structured execution patterns
This commit captures the trimmed-to-prompts workflow with complete stage
descriptions, artifact requirements, and validation processes.
* fix(security): update gitleaks to v8.29.0
- Update gitleaks from v8.18.4 to v8.29.0 to address security vulnerabilities
- Update CI workflow comment to specifically mention CHANGELOG.md instead of generic 'release-generated files'
* refactor(docs): extract embedded fonts to dedicated stylesheet
Extract font-face declarations from HTML files into a dedicated fonts.css stylesheet to reduce duplication and improve maintainability. Update HTML files to link the external stylesheet. Also includes minor style adjustments and configuration improvements.
- Create docs/assets/css/fonts.css with all @font-face declarations
- Remove embedded font definitions from 7 HTML files
- Update width properties to use full width instead of max-width
- Add exclusion for large files in pre-commit hooks
- Minor documentation and naming consistency updates
---------
Co-authored-by: Claude <[email protected]>1 parent b8875bf commit e336618
File tree
85 files changed
+15055
-8832
lines changed- .github
- workflows
- docs
- archive
- assets
- css
- fonts
- images
- background
- js
- references
- mcp_server
- slash_commands
- tasks
- tests
Some content is hidden
Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
85 files changed
+15055
-8832
lines changed| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | | - | |
| 1 | + | |
2 | 2 | | |
3 | 3 | | |
4 | 4 | | |
5 | | - | |
6 | | - | |
| 5 | + | |
7 | 6 | | |
8 | 7 | | |
9 | 8 | | |
10 | | - | |
11 | 9 | | |
12 | | - | |
13 | 10 | | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
14 | 14 | | |
15 | 15 | | |
16 | | - | |
17 | | - | |
18 | | - | |
19 | | - | |
20 | | - | |
21 | | - | |
22 | | - | |
23 | | - | |
24 | | - | |
25 | | - | |
26 | | - | |
27 | | - | |
28 | | - | |
29 | | - | |
30 | | - | |
31 | | - | |
32 | | - | |
33 | | - | |
34 | | - | |
35 | | - | |
36 | | - | |
37 | | - | |
38 | | - | |
39 | | - | |
40 | | - | |
41 | | - | |
42 | | - | |
43 | | - | |
44 | | - | |
45 | | - | |
46 | | - | |
47 | | - | |
48 | | - | |
49 | | - | |
50 | | - | |
51 | | - | |
52 | | - | |
53 | | - | |
54 | | - | |
55 | | - | |
56 | | - | |
57 | | - | |
58 | 16 | | |
59 | | - | |
| 17 | + | |
60 | 18 | | |
| 19 | + | |
| 20 | + | |
61 | 21 | | |
62 | | - | |
| 22 | + | |
63 | 23 | | |
64 | 24 | | |
65 | | - | |
66 | | - | |
| 25 | + | |
| 26 | + | |
67 | 27 | | |
68 | | - | |
69 | | - | |
70 | | - | |
71 | | - | |
72 | | - | |
73 | | - | |
74 | | - | |
75 | | - | |
76 | | - | |
77 | | - | |
78 | | - | |
79 | | - | |
80 | | - | |
| 28 | + | |
81 | 29 | | |
82 | | - | |
83 | | - | |
| 30 | + | |
| 31 | + | |
84 | 32 | | |
85 | | - | |
86 | | - | |
| 33 | + | |
| 34 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
3 | 9 | | |
4 | 10 | | |
5 | | - | |
| 11 | + | |
| 12 | + | |
6 | 13 | | |
7 | 14 | | |
8 | 15 | | |
| |||
16 | 23 | | |
17 | 24 | | |
18 | 25 | | |
19 | | - | |
| 26 | + | |
| 27 | + | |
20 | 28 | | |
21 | 29 | | |
22 | 30 | | |
23 | 31 | | |
| 32 | + | |
24 | 33 | | |
25 | 34 | | |
26 | 35 | | |
27 | 36 | | |
28 | 37 | | |
| 38 | + | |
29 | 39 | | |
30 | 40 | | |
31 | 41 | | |
32 | 42 | | |
33 | 43 | | |
34 | 44 | | |
35 | | - | |
36 | 45 | | |
37 | 46 | | |
38 | 47 | | |
| |||
52 | 61 | | |
53 | 62 | | |
54 | 63 | | |
55 | | - | |
56 | | - | |
| 64 | + | |
| 65 | + | |
57 | 66 | | |
58 | | - | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
9 | | - | |
10 | | - | |
11 | | - | |
12 | | - | |
13 | | - | |
14 | | - | |
15 | | - | |
16 | | - | |
17 | | - | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
18 | 15 | | |
19 | 16 | | |
20 | 17 | | |
| |||
33 | 30 | | |
34 | 31 | | |
35 | 32 | | |
36 | | - | |
| 33 | + | |
| 34 | + | |
37 | 35 | | |
38 | | - | |
39 | | - | |
40 | | - | |
41 | | - | |
42 | | - | |
43 | | - | |
44 | | - | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
This file was deleted.
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
0 commit comments