Skip to content

feat(skills): add change complexity tier assessment to propose and new workflows#2

Open
marcoskichel wants to merge 1 commit intomainfrom
kichelm/complexity-assessment
Open

feat(skills): add change complexity tier assessment to propose and new workflows#2
marcoskichel wants to merge 1 commit intomainfrom
kichelm/complexity-assessment

Conversation

@marcoskichel
Copy link
Copy Markdown
Collaborator

@marcoskichel marcoskichel commented Mar 31, 2026

Summary

  • Adds a tier assessment step (step 2) to both /opsx:propose and /opsx:new workflows that fires right after the user describes their change, before any OpenSpec scaffold is created
  • Classifies changes into three tiers and acts accordingly:
    • Tier A (trivial) — typo, formatting, comment-only, non-semantic refactor → warns the user a direct PR is sufficient, asks confirmation before proceeding
    • Tier B (small/low-risk) — minor UX/config tweak, refactor with preserved behavior, no API/data/security impact → suggests a lightweight schema, queries openspec schemas --json to find one
    • Tier C (meaningful) — behavior change, API/contract, migration, security/privacy, cross-team → proceeds silently with the full workflow

Motivation

OpenSpec's own contributing guidance recommends "progressive rigor" — small fixes go direct PR, larger changes use the full workflow. Without a gate, the agent defaults to full OpenSpec for everything, adding unnecessary overhead for trivial changes and eroding the value of the framework for the changes that actually matter.

Test plan

- [ ] Run `/opsx:propose` with a trivial change description (e.g. "fix typo in README") — expect Tier A warning + confirmation prompt
- [ ] Run `/opsx:propose` with a small change (e.g. "update button color") — expect Tier B lightweight suggestion
- [ ] Run `/opsx:propose` with a meaningful change (e.g. "add OAuth2 login flow") — expect no prompt, proceeds directly
- [ ] Same three scenarios for `/opsx:new`
- [ ] Build passes: `npm run build`

…w workflows

Add a tier assessment step (step 2) to /opsx:propose and /opsx:new that
classifies each change before creating any artifacts:

- Tier A (trivial): warns user a direct PR is sufficient, asks confirmation
- Tier B (small): suggests a lightweight schema, queries available schemas
- Tier C (meaningful): proceeds silently with full workflow

Prevents overhead for low-risk changes while preserving full rigor for
behavior changes, API/contract, migrations, and cross-team work.
@marcoskichel marcoskichel self-assigned this Mar 31, 2026
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.

1 participant