---

How it works

It starts the moment you fire up your coding agent. As soon as it sees you're building something, it doesn't jump straight into writing code. Instead it steps back and asks what you're really trying to do.

Once it's teased a spec out of the conversation, it shows it to you in chunks short enough to actually read and digest.

After you've signed off on the design, your agent puts together an implementation plan clear enough for an enthusiastic junior engineer with poor taste, no judgement, no project context, and an aversion to testing to follow. It emphasizes true red/green TDD, YAGNI, and DRY.

Next, once you say "go", it launches a subagent-driven-development process, having agents work through each task, inspecting and reviewing their work, and continuing forward.

Because the skills trigger automatically, you don't need to do anything special.

The workflow

flowchart TD
    A(["brainstorming"]):::stage
    B(["using-git-worktrees"]):::stage
    C(["writing-plans"]):::stage
    D{"how should<br/>this run?"}:::gate
    E(["subagent-driven-development"]):::stage
    F(["executing-plans"]):::stage
    G(["test-driven-development"]):::stage
    H(["requesting-code-review"]):::stage
    I(["verification-before-completion"]):::verify
    J(["finishing-a-development-branch"]):::verify

    A -->|design approved| B
    B --> C
    C --> D
    D -->|autonomous| E
    D -->|with checkpoints| F
    E --> G
    F --> G
    G --> H
    H -->|critical issues| G
    H -->|clean| I
    I --> J

    classDef stage fill:#7C6BF5,stroke:none,color:#FFFFFF,font-weight:600
    classDef verify fill:#22D3EE,stroke:none,color:#0B0F17,font-weight:600
    classDef gate fill:#F59E0B,stroke:none,color:#0B0F17,font-weight:600

Loading

The agent checks for relevant skills before any task. These are mandatory workflows, not suggestions — the loop back from code review to TDD is enforced, not advisory.

Installation

Claude Code

Register this repository as a marketplace, then install:

/plugin marketplace add charai17/devology

/plugin install devology@devology

Gemini CLI

gemini extensions install https://github.com/charai17/devology

Update later with gemini extensions update devology.

Factory Droid

droid plugin marketplace add https://github.com/charai17/devology

droid plugin install devology@devology

OpenCode

OpenCode uses its own plugin install. Tell OpenCode:

Fetch and follow instructions from https://raw.githubusercontent.com/charai17/devology/refs/heads/main/.opencode/INSTALL.md

Detailed docs: docs/README.opencode.md

Note: Devology is not listed in the official Claude, Codex, or Cursor plugin marketplaces. Install it from this repository using the commands above.

What's inside

Each skill lives in skills/<name>/SKILL.md and is invoked as devology:<name>.

Philosophy

Test-Driven Development	Write tests first, always
Systematic over ad-hoc	Process over guessing
Complexity reduction	Simplicity as the primary goal
Evidence over claims	Verify before declaring success

Contributing

Issues and PRs welcome at https://github.com/charai17/devology/issues.

See skills/writing-skills/SKILL.md for the guide to writing and testing skills.

License

MIT License — see LICENSE.

Copyright (c) 2025 Jesse Vincent       (original work)
Copyright (c) 2026 Anton Charalambidis (modifications)