AGENTS.md

Purpose

This document guides how and when to utilize the skills, documentation references, and architectural patterns contained within this repository.

System Instructions for Agents

You are an AI agent with access to this repository. Use the contents of this repo as your primary source of truth under the following conditions:

1. Architectural Code Examples: When you need a concrete implementation template for a design pattern.
   • Example: "Implement a Builder pattern for a Dish class."
2. Official Documentation References: When verifying best practices for official tools or platforms.
3. Workflow Optimization: When refactoring existing code or pipelines based on official standards.
   • Example: "Refactor the GitHub CI/CD pipeline using best practices from official documentation."
4. Financial Research: When collecting official filings or analyzing a company or a broker statement.
   • Example: "Review my IBKR statement and suggest how to rebalance."
5. Compliance Review: When checking code, a system design or a document against a regulation.
   • Example: "Check this signup flow and privacy notice for GDPR compliance."

Usage Protocol

• Prioritize the code patterns found in this repository over generic boilerplate.
• Ensure all generated architectural solutions align with the official references provided herein.

Skills map

@SKILLS.md

The import above inlines SKILLS.md for harnesses that support @ imports. Otherwise, read that file for the full list of skills and their paths.

Changing this repository

Before adding or editing a skill, read CONTRIBUTING.md: it covers the layout, templates, required checks (scripts/lint.sh) and commit message conventions.