Skip to content
/

OmniDev Kit

omnidev-kit · zy-eagle/omnidev-kit · ★ 1 · last commit 2026-05-23

Full-lifecycle AI development workflow skill for Claude Code: safety-first requirement alignment, adaptive phase planning, self-learning from session retrospectives.

Best whenContext-proportional loading (lazy phases) and self-evolving rules are more important than comprehensiveness — the framework should adapt to how teams actual…
Skip ifStarting implementation when requirements are ambiguous, Quick patches without root-cause analysis
vs seeds
openspec(phased workflow with artifact generation). Unique contributions: (1) self-evolution engine — agent logs corrections and…
Primitive shape 23 total
Commands 22 Skills 1
00

Summary

OmniDev Kit — Summary

OmniDev Kit is a Claude Code skill (/od) that orchestrates a 5-phase AI development workflow (Assess → Blueprint → Plan → Dev → Test) with extensive safety guardrails, bilingual support (Chinese/English), dynamic skill composition, T-shirt sizing for scope-adaptive phase skipping, and a self-evolution engine. It integrates concepts from superpowers, OpenSpec, planning-with-files, and everything-claude-code into a single unified skill. Commands are triggered by the /od prefix (22 commands with short aliases). Key features include: requirement alignment protocol that blocks ambiguous execution, lazy context loading per phase, cross-session memory via YAML frontmatter + Markdown files, interactive mode with numbered choice menus, and a self-learning system that proposes rule improvements from session retrospectives. With 1 star and PowerShell scripts for install, it targets Chinese enterprise teams.

Compared to seeds: closest to superpowers (skill-based behavioral framework) but with far more command surface (22 vs. 14 skills), phased workflow structure borrowed from openspec, and session state persistence similar to taskmaster-ai. The self-evolution engine has no direct seed equivalent.

01

Overview

OmniDev Kit — Overview

Origin

Created by GitHub user zy-eagle (published as zayeagle). Active development in May 2026. PowerShell install scripts suggest targeting Windows enterprise environments. README is bilingual (Chinese primary, English secondary).

Philosophy

From README:

"OmniDev Kit is an AI-driven development workflow toolkit that transforms the AI from a 'typist who only writes code on command' into a 'senior R&D engineer who understands cost control, architecture design, writes their own tests, and never forgets.'"

First Principles Safety Rules

Rule B.3 — Requirement Alignment:

"When requirements are vague, ambiguous, or missing key info, the AI is prohibited from guessing or self-interpreting. It must proactively confirm the core problem, final goal, delivery criteria, and root cause."

Rule B.4 — Problem Fix Protocol:

"For any bug fix, security patch, or behavior correction, the AI is prohibited from shipping a quick patch. It must first produce a complete solution plan with root cause analysis, impact scope, and regression risk."

Self-Description

From the README:

"OmniDev Kit is an AI-driven development workflow toolkit that integrates the core essence of top open-source AI frameworks (such as obra/superpowers, OpenSpec, planning-with-files, and everything-claude-code)"

This is the only framework in the batch that explicitly claims to synthesize multiple seed frameworks.

Bilingual Design

Chinese and English locale support:

  • /od cfg -l zh → Chinese mode (loads phases/zh/ files)
  • /od cfg -l en → English mode (loads phases/en/ files)
  • Only one locale loaded at a time — saves tokens

Activation Pattern

The skill activates ONLY when user message starts with /od. Without that prefix, behaves as normal conversation.

02

Architecture

OmniDev Kit — Architecture

Distribution

  • Type: standalone-repo (skill files + rules + install scripts)
  • Install: Remote URL method (preferred):
    /od install https://github.com/zayeagle/omnidev-kit.git
    
    Or manual copy of skills/ and rules/ directories.

Runtime Requirements

  • Claude Code
  • PowerShell (for install scripts on Windows)

Directory Structure

omnidev-kit/
├── INSTALL.md
├── README.md
├── README.zh-CN.md
├── rules/
│   └── 01-omnidev-workflow.mdc    # Lightweight trigger (alwaysApply: false)
└── skills/
    └── od/
        ├── SKILL.md               # Main spec — single source of truth
        ├── phases/
        │   ├── 00-assessment.md   # Root-level fallback
        │   ├── 01-02-planning.md
        │   ├── 03-development.md
        │   ├── 04-testing.md
        │   ├── zh/                # Chinese locale
        │   │   ├── 00-assessment.md
        │   │   ├── 01-02-planning.md
        │   │   ├── 03-development.md
        │   │   └── 04-testing.md
        │   └── en/                # English locale
        │       ├── 00-assessment.md
        │       ├── ...
        └── engine/
            ├── evolution.md        # Self-evolution engine
            ├── special-flows.md
            ├── zh/
            └── en/

Lazy Loading Architecture

Each phase declares context_requires listing exactly which files to load. The AI loads ONLY the listed files — no pre-reading downstream phases. This keeps token usage proportional to the current phase.

State Files

docs/omnidev-state/
├── context.yaml       # YAML frontmatter + Markdown session state
├── current-task.md
└── evolution-log.md   # Self-learning retrospective log
03

Components

OmniDev Kit — Components

Main Skill: od (SKILL.md)

Activates on /od prefix only.

Commands (22)

Command Alias Purpose
/od [requirement] Guided workflow
/od -f [requirement] Fast mode (skip blueprint/plan)
/od -p [requirement] Plan only
/od h /od help Show all commands
/od ob /od onboard Scan project → context doc
/od rv /od review Code review (read-only)
/od qa Dependency analysis → test
/od ch [req] /od change Change management
/od ln /od learn Self-learning retrospective
/od ln -r View learning log
/od ln -a Auto-apply pending proposals
/od ln --rb [N] Rollback evolution N
/od rp /od report Generate weekly report
/od ps /od push Commit + push
/od re /od resume Resume interrupted session
/od up /od update Update OmniDev Kit
/od i <url> /od install Install from Git URL
/od cfg /od config View/edit configuration
/od cfg -l zh|en Switch language
/od cfg -i on|off Toggle interactive mode
/od st /od stash Stash task context
/od po /od pop Pop stashed context
/od sy /od sync Sync to Jira/GitHub Issue
/od db /od dashboard ROI dashboard

Phase Files (5 per locale = 10 total)

Phase File Description
0 phases/00-assessment.md Complexity assessment (S/M/L/XL)
1-2 phases/01-02-planning.md Blueprint + Plan
3 phases/03-development.md Development
4 phases/04-testing.md Testing + QA

Engine Files (2 per locale = 4 total)

File Description
engine/evolution.md Self-evolution engine rules
engine/special-flows.md Change management, recovery flows

Rules

File Type
rules/01-omnidev-workflow.mdc alwaysApply: false trigger
05

Prompts

OmniDev Kit — Prompts

Excerpt 1: Requirement Alignment Rule (B.3) — Iron Law pattern

From skills/od/SKILL.md:

### B.3 Requirement Alignment (需求判定与对齐规则)

**第一性原理:需求不清不动手。**

分析用户需求时,凡遇到以下情况,**禁止擅自解读、禁止自我发挥、禁止直接开始任务**:
- 需求模糊、表述不清、存在歧义
- 关键信息缺失(目标、范围、验收标准等)
- 无法自行判定用户意图、最终目标或交付标准

**必须执行的动作**:主动向用户沟通确认,对齐以下要素:
1. **核心诉求**:用户到底要解决什么问题?
2. **最终目标**:期望达到的结果是什么?

Translation: "First principle: DO NOT start work if requirements are unclear. PROHIBITED: self-interpretation, improvisation, direct task start when: requirements are vague/ambiguous, key info is missing (goals, scope, acceptance criteria). MANDATORY: proactively clarify the core need, final goal, delivery criteria."

Technique: Iron Law with explicit prohibition syntax. Chinese 禁止 (prohibited) + 必须 (mandatory) parallels the English "SHALL NOT" / "SHALL" RFC 2119 keywords. The explicit list of what triggers the block and what must be confirmed before proceeding.


Excerpt 2: Self-Evolution Engine

From skills/od/engine/evolution.md:

The evolution engine:

  1. Passive Learning: logs corrections and error patterns during sessions
  2. Smart Proposals: generates rule improvement proposals when signals accumulate
  3. User Control: all changes require /od ln y explicit approval
  4. Safety: "Cannot weaken core rules. Full rollback via /od ln --rb [N]."

Technique: Meta-level prompt self-modification with safety guardrails. The system can propose changes to its own rules but cannot apply them without user confirmation, and cannot weaken safety rules.


Excerpt 3: Activation guard

---
name: od
description: >-
  OmniDev AI-driven development workflow. Use ONLY when the user's message 
  starts with /od (e.g. /od h, /od re, /od ob). Do not load or follow this 
  skill for normal chat without the /od prefix.
---

# OmniDev Workflow Skill — Full Specification

This file is the **single source of truth** for all OmniDev rules. The lightweight 
trigger lives in `rules/01-omnidev-workflow.mdc` (`alwaysApply: false`); **everything 
below applies only when the current user message starts with `/od`**

Technique: Prefix-gated activation with a lightweight MDC trigger file and a heavyweight SKILL.md. The MDC file just checks the prefix; all substance is in SKILL.md loaded on demand.

09

Uniqueness

OmniDev Kit — Uniqueness

differs_from_seeds

Closest seeds: superpowers (skill-based behavioral framework, prefix-triggered activation) and openspec (phased workflow with explicit artifact generation). OmniDev differs from superpowers in: (1) explicit 22-command surface with phase navigation (vs. superpowers' 14 autonomous skills with no commands); (2) session state persistence via YAML frontmatter in docs/omnidev-state/ (superpowers has no persistent state); (3) self-evolution engine that can propose modifications to its own rules. OmniDev differs from openspec in: OpenSpec focuses on planning artifacts before implementation; OmniDev covers the full dev lifecycle (assess → blueprint → plan → dev → test) with security, TDD, and enterprise reporting included in the same skill. The self-evolution engine — where the agent logs its own corrections and proposes rule changes subject to human approval — has no equivalent in any seed framework. The bilingual locale system (loading different phase files per language at runtime) is also unique.

Positioning

"Everything-in-one" senior developer assistant for Chinese enterprise teams. The self-description "integrates the core essence of obra/superpowers, OpenSpec, planning-with-files, and everything-claude-code" is accurate — this is the most feature-integrated framework in the batch, at the cost of complexity. The lazy loading architecture is a genuine performance contribution: other frameworks load all their prompts into context at session start; OmniDev loads only the files for the current phase.

Observable Failure Modes

  1. Activation guard is easy to bypass: the skill only activates on /od prefix — any conversation that starts without it proceeds without OmniDev's safety guardrails
  2. Self-evolution instability: proposals that pass /od ln y approval modify the skill's own rules. A series of poorly-reviewed proposals could degrade the skill's behavior in non-obvious ways.
  3. Chinese-first UX: while bilingual, the default state file contents and many error messages appear to be Chinese, which may confuse English teams using the tool in en mode
  4. No artifact schema: unlike OpenSpec's explicit artifact graph, OmniDev's phases produce blueprint.md and plan.md in unspecified formats — the schema is defined only in the phase prompt files, not machine-validated
  5. External skill discovery is fragile: scanning for skills in 4 local directories will produce different results on different machines, making the Dynamic Skill Composition behavior unpredictable in teams
04

Workflow

OmniDev Kit — Workflow

Complexity-Adaptive Phases

Size Phase Path Description
S (small) Skip to Dev directly Hot fix, direct code change
M (medium) Plan → Dev → Test Skip blueprint
L/XL (large) Blueprint → Plan → Dev → Test → Deploy Full workflow

Phase Sequence

Phase Artifacts Gates
0. Assess Complexity recommendation (S/M/L/XL)
1. Blueprint blueprint.md Human approval
2. Plan plan.md Human approval
3. Dev Code changes Git commit before start
4. Test Test report Coverage >= 90% gate

Approval Gates

Gate Type
Requirement Alignment (B.3) — must clarify vague requirements before starting freetext-clarify
Bug Fix Protocol (B.4) — must plan before patching freetext-clarify
Phase transition confirmation numbered-choice
Blueprint approval file-review
Plan approval file-review
Test coverage >= 90% typed-confirm

Interactive Mode

At every checkpoint, options are presented as a numbered list:

1. 继续 (/od next)
2. 修订 (/od adj)
3. 跳过 (/od skip)
4. 全部执行 (/od all)

User can reply with number (1) or alias (/od n).

Change Management

/od ch [new requirement] triggers:

  1. Impact assessment of mid-development change
  2. Archive old plan
  3. Generate new blueprint

Security by Design (Phase 3)

Mandated in development phase:

  • IDOR/BOLA prevention
  • Injection prevention
  • SSRF/CSRF protection
  • Sensitive data masking

High-level resilience (user-requested):

  • Circuit breaker, retry with backoff, bulkhead isolation
06

Memory Context

OmniDev Kit — Memory & Context

State Storage

docs/omnidev-state/
├── context.yaml         # YAML Frontmatter + Markdown session state
│   # Contains: phase, complexity, current requirement, plan status
├── current-task.md      # Current active task details
└── evolution-log.md     # Self-learning retrospective entries

Dual-State Format

From README:

"Dual-State Storage: YAML Frontmatter + Markdown — machine-precise and human-readable."

The context.yaml file stores structured state (current phase, active task, configuration) in YAML, while current-task.md provides a human-readable summary of the same state.

Context Pruning

"Context Pruning: Auto-archive when state files exceed 200 lines, preventing hallucinations."

When context.yaml exceeds 200 lines, the system automatically archives older entries and keeps only the most recent state.

Lazy Context Loading (B.7)

Each phase declares exactly what files it needs via context_requires. The AI loads ONLY the listed files:

  • Phase 0 (Assessment): reads project context only
  • Phase 1-2 (Planning): reads assessment output + project context
  • Phase 3 (Dev): reads plan + current task
  • Phase 4 (Test): reads plan + current task + test conventions

Files cached across phases within the same session. Never pre-reads downstream artifacts.

Session Recovery

/od resume loads state from docs/omnidev-state/ + compares with git status to reconstruct the current position.

Stash/Pop

/od st saves current task context to a stash slot. /od po restores it. Enables context switching between tasks.

Cross-Session Persistence

  • Scope: project (per-repository)
  • Persistence: yes — state files survive sessions
  • Compaction: auto-archive at 200 lines
07

Orchestration

OmniDev Kit — Orchestration

Multi-Agent

Yes — Dynamic Skill Composition (B.11) enables OmniDev to discover and invoke specialized external skills:

  1. Auto-detect troubleshooting/debugging intent from user keywords
  2. Scan local skills across 4 directories (project-level, user-level Cursor/Claude/Agents)
  3. Rank matches: Direct match (full workflow) vs Supporting (partial tools)
  4. User confirms before loading any skill
  5. After external skill completes, bridge back to OmniDev dev workflow

Orchestration Pattern

Sequential (phase-based) with optional skill composition for specialized workflows.

Subagent Definition Format

None formally defined. External skills are discovered by scanning local directories, not via predefined subagent definitions.

Isolation Mechanism

None. Edits in-place.

Multi-Model

No.

Execution Mode

Interactive-loop. Every phase transition offers a numbered choice menu. Auto-mode (/od all) executes all remaining phases without pausing.

Self-Evolution Engine

The most distinctive orchestration feature:

  • Logs corrections and error patterns passively during sessions
  • Generates rule improvement proposals when signals accumulate
  • Proposals require explicit /od ln y approval
  • Cannot weaken core safety rules
  • Full rollback via /od ln --rb [N]

This is a meta-level orchestration — the agent can propose modifications to its own workflow rules, subject to human approval.

Git Automation

From README (Phase 3 spec-driven engineering):

"Auto-Checkpointing: Git commit before any code modification."

/od ps command triggers: change impact summary → stage → commit message generation → push.

08

Ui Cli Surface

OmniDev Kit — UI & CLI Surface

Dedicated CLI Binary

No standalone binary. OmniDev Kit is a Claude Code skill triggered by /od prefix.

Interactive Mode

The most interactive UI in the batch (for a skill-based framework):

  • Numbered choice menus at every checkpoint
  • Users can reply with numbers (1/2/3) or aliases (/od n)
  • Configurable: /od cfg -i on|off toggles interactive mode
  • Auto Q&A loop: after every command, presents context-adaptive next actions

Command Aliases

Every command has a 1-2 letter alias:

/od ob (onboard)  /od rv (review)  /od qa (test)
/od ch (change)   /od ln (learn)   /od rp (report)
/od ps (push)     /od re (resume)  /od up (update)
/od st (stash)    /od po (pop)     /od sy (sync)
/od db (dashboard)

Enterprise Reporting

  • /od rp — management-ready weekly reports combining git history + state files
  • /od db — ROI efficiency dashboard with metrics
  • /od sy — sync output to Jira/GitHub Issue

No Local Web UI

No web dashboard. All interaction through Claude Code chat.

Language Switching

/od cfg -l zh   # Switch to Chinese
/od cfg -l en   # Switch to English

The locale switch changes which phase files are loaded (zh/ or en/ subdirectory).

Install

# Option 1: Remote (from within Claude Code)
/od install https://github.com/zayeagle/omnidev-kit.git

# Option 2: Manual copy
# Copy skills/ and rules/ to ~/.claude/

Related frameworks

same archetype · same primary tool · same memory type

BMAD-METHOD ★ 48k

Provides a full agile delivery lifecycle with named expert-persona AI collaborators that elicit the human's best thinking rather…

Agent OS ★ 4.6k

Extracts implicit codebase conventions into token-efficient markdown standards files and injects them selectively into AI agent…

Claude Conductor ★ 367

Gives Claude Code a persistent, cross-linked, auto-analyzed documentation system so it retains codebase context across sessions.

Spec-Driver (Greenfield Spec-Driven Development) ★ 25

Prevents spec rot in AI-assisted development by making implementation changes flow back into evergreen, authoritative specs via…

Anthropic Knowledge Work Plugins ★ 16k

Role-specialized plugin bundles with live MCP connectors that turn Claude into a domain expert for enterprise knowledge workers.

Codex Integration for Claude Code (skill-codex) ★ 1.3k

Single Claude Code skill that handles Codex CLI invocation correctly (stdin blocking, thinking token suppression, session resume)…