tips:openspec

OpenSpec

yay -S openspec

cd <project>

openspec init

from agent auto compile openspec\project.md with command

Please read openspec/project.md and help me fill out with details about my project, tech stack, and conventions.

it is possible to change openspec tools with “openspec init” and “openspec update”

1) create proposal

# kilocode
/openspec-proposal.md load multiple svm models
 
# other agents
/openspec:proposal load multiple svm models

file created

openspec/changes/
└── load-multiple-svm-models
    ├── proposal.md
    ├── specs
    │   └── svm-anomaly-detection
    │       └── spec.md
    └── tasks.md

Proposal Structure:

  • proposal.md: Explains why multiple models are needed (flexibility for different scenarios), what changes will be made, and the impact
  • tasks.md: Detailed implementation checklist broken into 5 phases (design, configuration, processor modification, main function updates, and testing)
  • spec.md: Specification deltas with both MODIFIED (existing SVM loading requirement) and ADDED (new model configuration requirement) sections, including proper scenarios

2) Review proposal.md and rebuild spec.md and tasks.md

update acceptance criteria for this proposal

3) Review spec.md and tasks.md

eventually check status of proposals

openspec view
openspec list    # Confirm the change folder exists
openspec validate load-multiple-svm-models
openspec show load-multiple-svm-models   # Review proposal, tasks, and spec delta

coding

# kilocode
/openspec-apply.md load-multiple-svm-models
 
# other agents
/openspec:apply load-multiple-svm-models

…testing…

Update tasks list

All tasks for the change [your-change-name] are finished. Please update the tasks.md

After implementation and testing, archive the change. All of the checkboxes in the TODO list were checked, and files were moved to the archive folder.

#openspec archive load-multiple-svm-models --yes
openspec archive load-multiple-svm-models --skip-specs --yes
  • tips/openspec.txt
  • Last modified: 2025/11/08 10:34
  • by sscipioni