OwnYourCode workflow
OwnYourCode makes Claude Code a mentor: the agent asks and reviews, and the human writes the code and understands every line
- 295 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The base install runs `curl | bash` with a script from the repository and creates `~/ownyourcode`
- The project script creates `.claude/commands/own`, `.claude/skills` and `ownyourcode/` in the project and merges instructions into your `CLAUDE.md`
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add workflows/ownyourcodeDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The base install runs `curl | bash` with a script from the repository and creates `~/ownyourcode`
- The project script creates `.claude/commands/own`, `.claude/skills` and `ownyourcode/` in the project and merges instructions into your `CLAUDE.md`
This is third-party code. Review the repository files before installing.
What it does
OwnYourCode is a set of `/own:*` commands and skills for Claude Code that changes the agent's role. The agent leads planning, asks guiding questions and reviews, and the human writes the code. There are four protocols: Active Typist (the agent gives patterns of at most 8 lines), Socratic dialogue, answers from verified documentation and systematic debugging by the READ, ISOLATE, DOCS, FIX scheme. Before a task is complete the code passes six checks: ownership, fundamentals, errors, security, performance and tests. The first blocks completion if you cannot explain your own code. A profile is chosen in `/own:init`: Junior, Career Switcher, Interview Prep, Experienced or Custom. The Interview Prep profile turns every task into a STAR story and a resume bullet by default. The project plan lives in one dashboard: the `dashboard.html` page renders data from `dashboard-data.js`, with no server. Lessons accumulate in a global registry at `~/ownyourcode/learning/`, and `/own:advise` brings them up before a new task. For current documentation the README advises connecting the Context7 and Octocode MCP servers.
Who it is for. Junior developers, career switchers and people preparing for interviews, and experienced programmers who want to run a project from a specification.
Good fit when
- A junior learns on a real project and wants the agent to ask questions while they write the code
- Preparing for an interview, you turn every task into a STAR story and a resume bullet
- Before closing a task it is useful to pass six checks: code ownership, fundamentals, errors, security, performance, tests
- The project plan is easier to run in one `dashboard.html` dashboard than in a dozen Markdown files
- You want to keep the experience of a task: `/own:retro` records what worked, and `/own:advise` brings up past lessons
Not a fit when
- The agent should simply hand over finished code: under the Active Typist rule it gives only patterns up to 8 lines
- You need a quick weekend prototype: every task goes through planning and six checks
- You work outside Claude Code: the commands live in `.claude/commands/own`
Example request
/own:feature Add email sign-up. Ask me design questions first and let me write the code myselfLimitations
- The approach slows work down: the human writes the code, and the agent only asks and reviews.
- Without the Context7 and Octocode MCP servers the quality of hints drops: the agent leans on the model's training data and does not check current documentation.
- Lessons live in the global `~/ownyourcode/learning/` folder shared by all projects, so `/own:advise` sees records from other repositories.
- The install scripts are written for macOS, Linux and Windows PowerShell.
How to disable. For a project there is the `project-uninstall.sh` script in `~/ownyourcode/scripts`, and `project-uninstall.ps1` exists for Windows. Delete the global `~/ownyourcode` folder by hand if you no longer need the projects.
FAQ
How do I install OwnYourCode?
Run the base script from the README in a terminal, which clones the repository into `~/ownyourcode`, then run `~/ownyourcode/scripts/project-install.sh` in the project folder. After that enter `/own:init` in Claude Code and pick a profile.
How do the profiles differ?
A profile changes the way of teaching, while the six checks and the review stay the same. Junior designs first and writes code through a predict-before-reveal loop, Interview Prep extracts a STAR story and a resume bullet from each task, and Experienced gets direct feedback. Change the profile with `/own:profile`.
How does OwnYourCode differ from Superpowers?
Superpowers gives the agent a development process with TDD and subagents, and the agent writes the code. OwnYourCode swaps the roles: the agent mentors, the human writes the code, and before a task completes it checks that you can explain your work.
What does the `/own:stuck` command do?
It starts systematic debugging by the READ, ISOLATE, DOCS, FIX scheme: the agent reads the error, narrows the cause, checks the documentation and only then gives a fix. Connecting Context7 is advised for the documentation check.
Which commands does OwnYourCode have?
The main path: `/own:init`, `/own:feature`, `/own:done`, `/own:retro`. Helpers: `/own:advise`, `/own:guide`, `/own:stuck`, `/own:status`, `/own:profile`, `/own:theme`, `/own:test` and `/own:docs`.
Discussion
No questions or reviews yet.
Related
WorkflowsA set of 11 skills for Claude Code, Codex and others: from understanding the task to a live site URL and a final report.
Over twenty skills for coding agents: MCP and hooks, plan mode, a bug-fix protocol, prompting and a bash safety hook
A Claude Code environment installer: CLAUDE.md, rules, skills, agents, hooks and two-layer project memory in one script
A set of Claude Code utilities: background skills, expert agents, slash commands and prompt templates for development
A workflow template for Claude Code and five more agents: a backlog task, a diff review and a commit.
A starter kit for Claude Code: a CLAUDE.md memory-bank template with ready hooks, subagents and skills you copy into your project
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| OwnYourCode (this card) | no | 295 | |
| Learning Opportunities | no | 2,552 | offers short learning exercises while coding, while OwnYourCode runs the whole task process with checks |
| Superpowers | no | 316,679 | gives a development process with TDD and subagents, and the agent writes the code |
README in short
The README opens with the problem: AI tools optimize for speed and the human loses an understanding of the code. A profile table, a quick start, the protocols, six gates, a command list, an MCP section and the philosophy follow. The dashboard that keeps the project plan in one data file closes the page.