From ijoka
CRITICAL: Ijoka is installed. This skill defines the complete software development process for this project. Use this skill for ALL work - every coding session, every task, every feature. Ijoka tracks all activity, attributes work to features, and provides cross-session continuity. You MUST follow this process.
npx claudepluginhub shakestzd/ijoka --plugin ijokaThis skill uses the workspace's default tool permissions.
**Ijoka is the software development process for this project.** When Ijoka is installed, you MUST follow this process for ALL work. Every activity is tracked, attributed to work items, and persisted across sessions.
Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.
Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
Ijoka is the software development process for this project. When Ijoka is installed, you MUST follow this process for ALL work. Every activity is tracked, attributed to work items, and persisted across sessions.
See IJOKA_POLICY.md in the plugin directory for complete policy documentation.
SessionStart ──► Records session, provides context, auto-starts API
PreToolUse ────► Smart feature matching, activity attribution
PostToolUse ───► Tracks ALL tool calls, links to features, syncs TodoWrite
UserPromptSubmit► Captures queries, classifies features
SessionEnd ────► Parses transcript, generates summary
| Type | Purpose | Command |
|---|---|---|
| Feature | New functionality | /add-feature "desc" |
| Bug | Defect fix | /bug "desc" |
| Spike | Research/investigation | /spike "desc" |
| Subtask | Child of feature | /subtask "desc" |
You MUST have at least one active work item before doing any coding work.
# 1. Check project status
curl -s http://localhost:8000/status | jq
# 2. If no active feature, start one
curl -s -X POST http://localhost:8000/features/{id}/start
# 3. Or create a new work item
/add-feature "Description"
/bug "Bug description"
/spike "Research topic"
Ijoka supports multiple features in progress simultaneously (WIP limit: 3).
When multiple features are active, PostToolUse hook scores activity:
| Scenario | Attribution |
|---|---|
| Files related to Feature A | → Feature A |
| Files related to Feature B | → Feature B |
| Ambiguous files | → Most recently active |
| No active features | → "Session Work" (unattributed) |
AI agents MUST use the REST API for ALL Ijoka operations.
| Method | Endpoint | Purpose |
|---|---|---|
| GET | /status | START HERE - Project status, active features |
| GET | /features | List all work items |
| POST | /features | Create work item |
| POST | /features/{id}/start | Start working on feature |
| POST | /features/{id}/complete | Mark complete |
| GET | /plan | Get steps for active feature |
| POST | /plan | Set steps |
| Method | Endpoint | Purpose |
|---|---|---|
| POST | /features/{id}/link/{parent_id} | Link as child |
| GET | /features/{id}/tree | Get hierarchy tree |
| GET | /features/{id}/children | Get children |
USE IJOKA FOR ALL TASK TRACKING - NOT INTERNAL TODOS
/plan Step 1 | Step 2 | Step 3
Or via API:
curl -X POST http://localhost:8000/plan \
-H "Content-Type: application/json" \
-d '{"steps": ["Step 1", "Step 2", "Step 3"]}'
Note: If you use TodoWrite, it's synced to Steps via hook - but prefer the API.
curl -s http://localhost:8000/statuscurl -s http://localhost:8000/plan/set-feature {id} when neededcurl -X POST http://localhost:8000/features/{id}/completeWhen deciding what to work on:
| Command | Purpose |
|---|---|
/add-feature | Create feature |
/bug | Create bug |
/spike | Create research item |
/subtask | Create child of current feature |
/plan | Set/view implementation steps |
/set-feature | Switch active feature |
/complete-feature | Mark complete |
/feature-status | Show progress |
/next-feature | Start next pending |
/plan, not internal todos/plan