HOWTO-SSOT
1.4.0Architecture single-source-of-truth operating system: bootstrap new projects, repair existing ones, enforce docs and AGENTS policy, and optionally index the result for local retrieval.
Downloads and runs the installer. Cloning the repository is not required.
macOS, Linux and WSL
curl -fsSL https://agentkits.ominot.es/i/howto-ssot | bash Windows (PowerShell)
irm https://agentkits.ominot.es/i/howto-ssot.ps1 | iex Update an existing install
curl -fsSL https://agentkits.ominot.es/i/howto-ssot | bash -s -- --update --auto The update command recovers the token, endpoint and CLI list from the configs already on disk, so nothing has to be pasted again.
Answered once and remembered, so reinstalling and updating stay silent. Pass --set id=value to answer up front, or --no-companions to decline the extras.
Is this a new project or an existing one?
mode=newNew project generate the SSoT from requirementsmode=existingExisting project default audit the code, then repair the docs
How should the agent read the architecture docs?
retrieval=textText only default the agent reads the markdown itself; nothing to runretrieval=mcpLocal MCP index adds a local full-text index over docs and symbols
Companion skills
Installed through their own ecosystem's CLI, after this kit is written. Declining one never fails the install, and an already-installed skill is left alone.
find-skillsoffered by default vercel-labs/skills Lets the agent discover stack-specific skills, which the bootstrap workflow asks it to do.
Skills
- howto-ssot
Commands
- /ssot
- The procedure is a tool, not part of your codebase: the skill and the /ssot command are installed outside the repository and removed once the run ends.
- What stays is what the agent wrote — docs/architecture and the AGENTS.md rule that keeps it true.
- The index builds itself on first use and lives in .agents/cache/, which is gitignored. Nothing needs to be started, and no port is opened.