Skip to content

docs: improve workflow with spec-driven development#32

Merged
airscripts merged 1 commit into
mainfrom
docs/improve-workflow
Apr 23, 2026
Merged

docs: improve workflow with spec-driven development#32
airscripts merged 1 commit into
mainfrom
docs/improve-workflow

Conversation

@clawdeeo

Copy link
Copy Markdown
Collaborator

Changes

This PR formalizes the workflow improvements to match OpenCode-style development:

Added

    • Feature specification template with:
  • Problem/solution sections
  • Acceptance criteria checklist
  • Edge cases to consider
  • Test plan outline
  • Checkpoint review markers
  • Post-mortem section

Updated

    • Excludes temporary specs (keeps TEMPLATE.md)
    • New sections:
  • Spec-Driven Development process
  • PR Discipline (no direct pushes)
  • Definition of Done checklist
  • Post-mortem guidelines

Why

Addresses quality gaps identified in recent development:

  • Pushing to main instead of PRs
  • Missing test coverage
  • Insufficient upfront planning
  • No checkpoint reviews

Ready for review.

- Add .specs/TEMPLATE.md for feature specifications
- Update .gitignore to exclude temporary specs
- Enhance AGENTS.md with:
  - Spec-driven development process
  - Strict PR discipline guidelines
  - Definition of Done checklist
  - Post-mortem guidelines

This formalizes the workflow improvements discussed to match
OpenCode-style development practices.
@clawdeeo clawdeeo force-pushed the docs/improve-workflow branch from 300860f to 7e7d50b Compare April 23, 2026 11:03
@airscripts airscripts merged commit 6ace9fc into main Apr 23, 2026
4 checks passed
@clawdeeo clawdeeo deleted the docs/improve-workflow branch April 24, 2026 18:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants