The engineering and agent-operation standards of
projectious.work, plus the tooling that delivers
them to AI coding agents (Claude Code, Codex, and any harness that reads
AGENTS.md and .agents/skills/).
| Path | Content |
|---|---|
standards/ |
One Markdown file per standard; each ends with an ## Agent briefing. |
standards/schemas/ |
JSON schemas referenced by standards. |
standards/sources/ |
Third-party material that standards adapt, kept unmodified. |
scripts/standards.py |
Installs, regenerates, and checks the standards in a repository. |
The standards cover agent communication, execution budget, building, and use; Git branching (GitHub Flow) and releases; specification layout and spec-driven development; architecture and refactoring; application engineering (Twelve-Factor App alignment, CLI design); agent interfaces; security; public documentation; user-interface design; and roadmaps.
Each standard loads in three levels so only what a task needs enters context:
- Always on: the communication and execution-budget briefings, written
into the repository's
AGENTS.mdbetweenCOMPANY_STANDARDSmarkers. - Skills: one
standard-*skill per standard group in.agents/skills/(with.claude/skills/symlinks), loaded when the task matches. - Full standard: the file the skill names; it is authoritative.
From a clean checkout of a release tag:
git clone --branch <tag> https://github.com/projectious-work/standards /tmp/standards
python3 /tmp/standards/scripts/standards.py install /path/to/repoThis vendors the bundle into .standards/ (with lock.json recording version,
commit, and file hashes), generates the skills, and writes the always-on block
into AGENTS.md. Commit the result through a chore/ pull request.
In the repository afterwards:
python3 .standards/standards.py check # exit 1 on local edits or drift
python3 .standards/standards.py sync # regenerate skills and AGENTS.md block
python3 .standards/standards.py check-specs --base main # spec/ rulesTo upgrade, rerun install from a newer tag.
- Edit
standards/<file>.mdon achore/branch, including its## Agent briefing. - Run
python3 scripts/standards.py sync;sync --checkexits 1 on drift. - Merge after owner approval; releases follow
standards/git-branching-and-releases.mdand are listed inCHANGELOG.md.
Standards text: CC BY 4.0. Scripts: MIT.
standards/sources/ keeps its own licenses.