Terezinha Tech Operations
Code got cheap.
Judgment didn’t.
ttoss is how we build products with AI agents, written down and open-sourced: the principles we reason from, the guardrails that enforce them, and 50+ TypeScript packages your agents can reuse instead of reinventing.
Fetch and follow the instructions at
https://ttoss.dev/ttoss-instructions.txt.Paste it into Copilot, Cursor, Claude, or any agent’s instructions so it checks the ttoss packages before writing new code. How it works
When generating code is cheap, three things stay scarce.
Knowing what to build
Small batches, fast feedback, and decisions priced in economic terms instead of opinions.
Product development →Proving it is correct
Verification is the loop that makes generated code committable. Coverage never goes down.
Tests pillar →Undoing it when it is not
Atomic changes, feature flags, and migrations written with their rollback, so being wrong is survivable.
Reversibility →
Every page on this site exists to make one of those three cheap enough to do at the speed agents produce change.
From laws to code, one layer at a time.
Read top-down to understand why the practices look the way they do. Read bottom-up if you have a codebase to change on Monday.
- PrinciplesWhat is true about working with agents, whether or not you act on it?
- FoundationsWhat must be true of a team before agentic execution pays off?
- PillarsWhich properties did we mechanize so they hold when attention does not?
- Guidelines & workflowHow exactly do we do it in this repository?
- Packages & CarlinWhat can I install instead of writing it again?
Enforced, not remembered.
An agent has no institutional memory. It complies with what is enforced and interpolates the rest. So every rule we care about is a check a machine runs — including on this repository.
Engineering pillars →- Coverage thresholds live in every package’s Jest config and are only ever raised.
tests/unit/jest.config.ts - Pull requests fail if lint would change a single file.
.cicd/commands/pr.sh - Dependency versions must match across the whole monorepo.
syncpack lint - This site refuses to build with a broken link or anchor.
docusaurus.config.ts
Configure once at the root. Every package adapts.
Theme, translations, and notifications come from providers, not props — so packages compose without prop drilling, and an agent has one convention to follow instead of fifty.