OpenSpec-driven development for AI coding assistants.

OpenSplx aligns humans and AI coding assistants with spec-driven development. Agree on what to build before any code is written. No API keys required.

Fork of OpenSpec with extended task management, review workflows, and automatic migration from OpenSpec projects.

npm install -g @appboypov/OpenSplx
splx --version

Prerequisites: Node.js >= 20.19.0

cd my-project
splx init

This creates the workspace/ directory structure and configures slash commands for your AI tools.

1. Draft    → Create a change proposal capturing spec updates
2. Review   → Iterate with your AI until everyone agrees
3. Implement → AI works through tasks referencing agreed specs
4. Archive  → Merge approved updates into source-of-truth specs

Note: splx list is deprecated. Use splx get changes, splx get specs, or splx get reviews instead.

Note: splx show is deprecated. Use splx get change --id <id> or splx get spec --id <id> instead.

All OpenSplx commands work from any subdirectory within a project. The CLI automatically finds the project root by scanning upward for workspace/AGENTS.md.

In monorepos, items display with project prefixes (e.g., project-a/add-feature). Use --workspace to filter operations.

Transfer options: --source <path>, --target-name <name>, --dry-run, --yes, --json.

Tasks are stored centrally in workspace/tasks/ as numbered files:

workspace/tasks/
├── 001-add-feature-implement.md          # Parented task (linked to change)
├── 002-add-feature-review.md             # Parented task (linked to change)
├── 003-standalone-task.md                # Standalone task
└── archive/                              # Archived tasks
    └── 001-completed-task.md

Task Filename Patterns:

• Parented tasks: NNN-<parent-id>-<kebab-case-name>.md (e.g., 001-add-feature-implement.md)
• Standalone tasks: NNN-<kebab-case-name>.md (e.g., 003-standalone-task.md)

Each task uses YAML frontmatter for status, skill-level, and parent linking:

---
status: to-do  # or: in-progress, done
skill-level: medior  # or: junior, senior (optional, guides AI model selection)
parent-type: change  # or: review, spec (optional, for parented tasks)
parent-id: add-feature  # optional, for parented tasks
---

Prioritization: Changes with highest completion percentage are prioritized first. Within a change, the first to-do or in-progress task is selected.

Auto-completion: When all Implementation Checklist items are checked, the task is automatically marked done and the next task begins.

Add inline feedback markers during code review:

// #FEEDBACK #TODO | Validate input before processing

# #FEEDBACK #TODO | Add error handling here

<!-- #FEEDBACK #TODO | Missing accessibility attributes -->

For parent-linked feedback, include parent type and ID in the marker:

// #FEEDBACK #TODO | change:add-feature | Validate input before processing
// #FEEDBACK #TODO | spec:user-auth | Update validation logic

Parse markers with: splx parse feedback review-name --parent-id <id> --parent-type change|spec|task

When you run splx init, these commands are installed for supported AI tools:

• /splx/plan-request - Clarify intent via iterative yes/no questions
• /splx/plan-proposal - Scaffold change proposal (auto-consumes request.md)
• /splx/plan-implementation - Orchestrate multi-agent task handoff for a change
• /splx/get-task - Get next prioritized task
• /splx/copy-next-task - Copy next task or feedback block to clipboard
• /splx/copy-review-request - Copy review request with workspace/REVIEW.md guidelines to clipboard
• /splx/copy-test-request - Copy test request with workspace/TESTING.md configuration to clipboard
• /splx/complete-task - Mark task as done
• /splx/undo-task - Revert task to to-do
• /splx/implement - Implement current task with guided workflow
• /splx/orchestrate - Coordinate sub-agents for multi-task work
• /splx/refine-architecture - Create or update workspace/ARCHITECTURE.md with spec-ready component inventories
• /splx/refine-review - Create or update workspace/REVIEW.md template
• /splx/refine-release - Create or update workspace/RELEASE.md template
• /splx/refine-testing - Create or update workspace/TESTING.md template
• /splx/test - Run tests based on scope (change, task, or spec)
• /splx/review - Review implementations
• /splx/parse-feedback - Parse feedback markers
• /splx/prepare-release - Guided release preparation workflow
• /splx/prepare-compact - Preserve session progress for context continuity
• /splx/sync-workspace - Sync workspace state across changes

pnpm install
pnpm run build
pnpm test

MIT