AGENTS.mdA

AGENTS.md from rshade/finfocus is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add rshade/finfocus/AGENTS.md@git:20261021.cfcb7b3

Pins git:20261021.cfcb7b3 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
rshade/finfocus
Path
AGENTS.md
Versions recorded
11
Latest version
git:20261021.cfcb7b3, committed Oct 21, 2026
First version recorded
Jan 19, 2026
Size
7,037 bytes
Repository stars
11
License
Apache-2.0

Repository guidelines for AI agents working with the FinFocus codebase.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

## Repository Guidelines

**Table of Contents:**

- [Project Snapshot](#project-snapshot)
- [Build, Lint, and Test Commands](#build-lint-and-test-commands)
- [Go Formatting and Imports](#go-formatting-and-imports)
- [Types, Naming, and API Surface](#types-naming-and-api-surface)
- [Error Handling and Control Flow](#error-handling-and-control-flow)
- [Logging Expectations](#logging-expectations)
- [Testing Guidelines](#testing-guidelines)
- [Testify Assertions (Required)](#testify-assertions-required)
- [Documentation and Markdown](#documentation-and-markdown)
- [Commit and PR Guidance](#commit-and-pr-guidance)
- [Security and Configuration](#security-and-configuration)
- [Common Workflows](#common-workflows)
- [Current Stack](#current-stack)
- [Cursor/Copilot Rules](#cursorcopilot-rules)
- [Active Technologies](#active-technologies)
- [Recent Changes](#recent-changes)

### Project Snapshot

- Go CLI for finfocus in `cmd/finfocus` with unexported logic in `internal/`.
- Fixtures live in `examples/`, `testdata/`, and `test/e2e/fixtures/`.
- Docs are in `docs/`; scripts in `scripts/`; build artifacts in `bin/`.

### Build, Lint, and Test Commands
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add rshade/finfocus/AGENTS.md@sha256:39f1c7289b4aa540

The line at the top of this page pins the label git:20261021.cfcb7b3, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_7khbop37scxvz5bf.svg)](https://markdownregistry.com/a/art_7khbop37scxvz5bf)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 11 versions of this file, between Jan 19, 2026 and Oct 21, 2026, about one every 27 days.

versioncommittedcommitsizeaudit
git:20261021.cfcb7b3 latest2026-10-21 cfcb7b3 7,037 BA view · diff
git:20261019.220dbe72026-10-19 220dbe7 7,037 BA view · diff
git:20261019.2a766712026-10-19 2a76671 6,641 BA view · diff
git:20261019.7767e6b2026-10-19 7767e6b 6,641 BA view · diff
git:20260923.e2c95ec2026-09-23 e2c95ec 6,522 BA view · diff
git:20260909.79f9c712026-09-09 79f9c71 6,210 BA view · diff
git:20260723.c0239aa2026-07-23 c0239aa 6,210 BA view · diff
git:20260606.a1c76182026-06-06 a1c7618 6,210 BA view · diff
git:20260130.5aaefc42026-01-30 5aaefc4 6,209 BA view · diff
git:20260121.dfa62fb2026-01-21 dfa62fb 6,209 BA view · diff
git:20260119.6edb8ef2026-01-19 6edb8ef 4,852 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (7037 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

rshade/finfocus · 11 stars · license Apache-2.0 · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_7khbop37scxvz5bf
GET https://markdownregistry.com/api/v1/resolve?ref=rshade/finfocus/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/39f1c7289b4aa540d97213ed183fd90a10099a6d753102d142bd2ae5f7ff38e3

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from rshade/finfocus

pick-issue SKILL.md skill
rshade/finfocus · .agents/skills/pick-issue/SKILL.md · Choose and claim one FinFocus roadmap issue, implement it through the repository workflow, prepare a pull request, and…
git:20260928.c9610e5 · audit A · 11 stars
promote-issue SKILL.md skill
rshade/finfocus · .agents/skills/promote-issue/SKILL.md · Triage the finfocus roadmap backlog and promote the next issue(s) to roadmap/current. Use when the user asks "what…
git:20260928.fa00919 · audit A · 11 stars
speckit-analyze SKILL.md skill
rshade/finfocus · .agents/skills/speckit-analyze/SKILL.md · Perform a non-destructive cross-artifact consistency and quality analysis across spec.md, plan.md, and tasks.md after…
git:20261019.220dbe7 · audit A · 11 stars
speckit-checklist SKILL.md skill
rshade/finfocus · .agents/skills/speckit-checklist/SKILL.md · Generate a custom checklist for the current feature based on user requirements.
git:20261019.220dbe7 · audit A · 11 stars
speckit-clarify SKILL.md skill
rshade/finfocus · .agents/skills/speckit-clarify/SKILL.md · Identify underspecified areas in the current feature spec by asking up to 5 highly targeted clarification questions and…
git:20261009.03628d0 · audit A · 11 stars
speckit-constitution SKILL.md skill
rshade/finfocus · .agents/skills/speckit-constitution/SKILL.md · Create or update the project constitution from interactive or provided principle inputs, ensuring all dependent…
git:20261009.03628d0 · audit A · 11 stars
speckit-converge SKILL.md skill
rshade/finfocus · .agents/skills/speckit-converge/SKILL.md · Assess the current codebase against the feature's spec, plan, and tasks, then append any remaining unbuilt work as new…
git:20261009.03628d0 · audit A · 11 stars
speckit-implement SKILL.md skill
rshade/finfocus · .agents/skills/speckit-implement/SKILL.md · Execute the implementation plan by processing and executing all tasks defined in tasks.md
git:20261009.03628d0 · audit A · 11 stars
speckit-plan SKILL.md skill
rshade/finfocus · .agents/skills/speckit-plan/SKILL.md · Execute the implementation planning workflow using the plan template to generate design artifacts.
git:20261009.03628d0 · audit A · 11 stars
speckit-specify SKILL.md skill
rshade/finfocus · .agents/skills/speckit-specify/SKILL.md · Create or update the feature specification from a natural language feature description.
git:20261009.03628d0 · audit A · 11 stars
speckit-tasks SKILL.md skill
rshade/finfocus · .agents/skills/speckit-tasks/SKILL.md · Generate an actionable, dependency-ordered tasks.md for the feature based on available design artifacts.
git:20261019.220dbe7 · audit A · 11 stars
speckit-taskstoissues SKILL.md skill
rshade/finfocus · .agents/skills/speckit-taskstoissues/SKILL.md · Convert existing tasks into actionable, dependency-ordered GitHub issues for the feature based on available design…
git:20261009.03628d0 · audit A · 11 stars

Every file in rshade/finfocus

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261102.920d634 · audit A · 433,876 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 314,583 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 299,696 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 199,595 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 185,249 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 144,492 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261107.ef99eb5 · audit A · 140,694 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20261106.e45976c · audit A · 118,366 stars

Browse by kind, by grade A, or by owner.