EOS

EOS is Tillo's Engineering Operating System. It holds shared engineering standards, AI skills, repository guidance, and developer tools. Read Why this exists in the repository README for the full rationale.

This section documents the EOS system and this repository.

Harbourmaster

Harbourmaster documentation describes the EOS GitHub pull request review runner and its operating model.

Install plugins and skills

• Consume the EOS plugin marketplace: install and maintain EOS plugins with APM.
• Use the Aikido plugin: install the Aikido MCP integration and configure interactive or headless authentication.

Run the AI-enabled SDLC

• Use the AI-enabled SDLC: take work from an idea to a draft pull request with the EOS skills.
• Connect SDLC integrations: connect Notion, Atlassian, and the GitHub CLI for those skills.

Verify a change

• Finalise a repository change: run affected Nx checks and report completion evidence.
• Run Git hook checks: install Lefthook and validate commit messages, staged files, and documentation links.
• Use Fallow: run local code health analysis and review machine-readable findings.
• Use incremental mutation tests: run Stryker with local and CI baselines.

Use Scout and documentation search

• Use Scout: install the Scout CLI and complete first setup.
• Install the EOS Docs MCP server: connect Cursor, Claude Code, or PhpStorm with Junie to the EOS documentation search.
• Add an external documentation source: register a GitHub repository's Markdown docs for rendering on the docs site.

Write a Compass smoke report

• Use Compass: validate a versioned evaluation suite and write a local smoke report.

Create and resolve spikes

• Create a spike ticket: record unknowns that block a clear route to a known destination.
• Resolve a spike ticket: record decisions on an existing spike before it reaches a done status.

Reference

• EOS marketplace skills: find the skills distributed through the EOS marketplace.
• Nx task execution and cache: tool responsibilities, task commands, cache behaviour, and CI constraints.
• Scout CLI: Scout commands, flags, output, and working-state snapshot contract.
• Compass CLI: Compass commands, flags, suite fields, and the report contract.

Architecture decisions

• 0001 Use Turborepo for the EOS monorepo: superseded by the Nx decision.
• 0003 Use Oxc for linting and formatting: lint and format source with Oxc through Ultracite.
• 0004 Lint Markdown and validate links in CI: check user-authored documentation in CI.
• 0005 Use Lefthook for repository Git hooks: install and run repository-managed Git hooks.
• 0006 Use Commitlint's conventional configuration: validate commit messages with the conventional preset.
• 0007 Use Nx for EOS task execution: current task-runner decision.