ginotrinh

Agos — Code Quality skill for Claude Code

Code Quality community

Governance kit for coding agents: operating rules, hooks that block repeated failures, a HANDOFF format, each with the evidence of what it prevents.

How to install Agos

This entry records only its repository, not the path inside it, so there is no exact command to give. Open ginotrinh/agos and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agos does

Governance kit for coding agents: operating rules, hooks that block repeated failures, a HANDOFF format, each with the evidence of what it prevents. Built on Claude Code.

Alternatives in Code Quality

Import Drawio — Redraw a draw.io file as an editorial diagram at a chosen format, size, and detail level 27.2k ★
Job Stories — Create job stories with acceptance criteria in JTBD format 7.8k ★
Video Script: Claude SEO V1.7.2 — What's New — Duration: ~5 minutes Tone: Natural, conversational, like talking to a friend who knows Claude Code Format: Scr 5k ★

README

agos - Agent Governance Operating System

[![tests](https://github.com/ginotrinh/agos/actions/workflows/test.yml/badge.svg)](https://github.com/ginotrinh/agos/actions/workflows/test.yml)

agos is an open-source governance kit for coding agents, built and tested on Claude Code. It gives an agent a set of operating rules, hooks that block failures which already happened more than once, a `HANDOFF.md` format that carries work between sessions, and scripts that check format rules mechanically. Every rule and pattern ships with the evidence of what it prevents.

Status: version 0.1.0. See [CHANGELOG.md](CHANGELOG.md).

Why

Rules written in prose are not enough, because an agent decides what to do when it types the command, not when it read the rule. agos keeps the rule text short, attaches the reason and the evidence, and puts a hook or a script at the moment of the decision wherever a failure repeated. Four examples from the files in this repository:

A hook for a mistake that was already documented. The pattern AGOS-PAT-002 (patterns/zsh-equals-expansion-breaks-separator-echo.md) records four occurrences of echo ==== breaking a whole command under zsh, the fourth in the very session that had just written the pattern down. Only after that did it become a hook, hooks/zsh-equals-guard.sh, which blocks the command before it runs.
A silent failure caught by an assertion. AGOS-PAT-001 records a bulk-edit script that ran clean over 15 files and changed no byte, because a heredoc consumed one level of backslash. The pattern lists five dated occurrences, the hook hooks/heredoc-backslash-guard.sh, and the rule to assert old in s before writing.
A rule tested against a baseline. AGOS-RUL-003 section 7 describes a pressure test: run the scenario without the rule first, record the excuses, then add the rule. For the rule against committing into another project's repository, a baseline without the rule committed and pushed the other repo on bo