revans

Rails engineering principles — Rails-first design, DRY, SRP, concerns (3-method rule), REST, no service objects, business logic in models, dependency discipline. Shared by architect (designs to these), engineer (builds to these), and review agents (checks against these).

CLI reference for bin/agent-log — agent activity logging tool. Provides run lifecycle management, decision logging, event logging, and query commands backed by db/agent_log.sqlite3.

The 12-section feature specification format — used by the architect to write feature specs and by the orchestrator to validate spec completeness before handing to the engineer.

Project design system rules — CSS framework, visual grammar, component classes, and UI generation surface patterns. Read this before designing or reviewing views to understand the project's visual constraints.

Handoff contract between the discovery agent and the architect agent. Defines what a complete brief contains, what level of detail prevents follow-up questions, and what the architect can derive from the codebase vs. what must come from the user.

DEPRECATED — this skill has been replaced by the generic design-system skill at skills/design-system/SKILL.md. This directory can be deleted.

Use this skill when the AI SEO agent is annotating a spec page's HTML with topic and kind attributes. Covers the AP reading layer — the structural mechanism that gives AI agents precise XPath addresses into page sections without reading the full document. Does not cover the AP pipeline layer (ap-gate, ap-gen, etc.) — spec pages are static HTML, not stateful pipeline documents.

Use this skill when the AI SEO agent is optimizing a page for discoverability by AI systems. Covers the five signals that make a page extractable and citable by Claude, ChatGPT, Perplexity, and future AI search tools — entity clarity, answer density, definition clarity, citation structure, and attribution.

Use this skill when the build agent is writing JavaScript animations for a spec page. Provides six named patterns — scroll-triggered reveals, SVG path draw, counter animation, hero title entrance, tab transitions, and typewriter — with working code and guidance on when to reach for each one.

Use this skill when the AI SEO agent needs to generate an llms.txt entry for a spec page, or when the deploy agent needs to update the site-wide llms.txt file. Documents the llms.txt standard, the entry format for robertrevans.com spec pages, and how individual page entries compose into the site-level index.

Use this skill when the discovery agent needs to produce a structured brief, or when the build agent needs to read one. Defines what a complete brief contains, all eight required sections, the artifact naming convention, and the completeness checklist discovery must pass before handing off to @blueprint.

Use this skill when the build agent is about to write any HTML for a spec page. Provides the path to The Point's llm.md component reference, the list of available mood files, the required CSS load order, and the hard rule against inventing bp- class names.

The Agent Spec Protocol (AP) — the complete spec for encoding agent routing, pipeline state, and content contracts in HTML documents using ap- custom elements. Read this before producing or validating any AP-compliant HTML document.

Validates an HTML file against the Agent Spec Protocol. Reads the file, runs every rule in the validation checklist, and returns a structured pass/fail report with XPath locations for every violation.