AGENTS.mdA

AGENTS.md from verygoodopensource/vgv-ffca-plugin is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add verygoodopensource/vgv-ffca-plugin/AGENTS.md@git:20261021.79ecd2a

Pins git:20261021.79ecd2a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
verygoodopensource/vgv-ffca-plugin
Path
AGENTS.md
Versions recorded
5
Latest version
git:20261021.79ecd2a, committed Oct 21, 2026
First version recorded
Sep 29, 2026
Size
8,177 bytes
Repository stars
6
License
MIT

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

# VGV FFCA Plugin

## Project Overview

VGV FFCA Plugin teaches Claude Code the Feature-First Clean Architecture (FFCA) for Flutter monorepos. It ships skills, one read-only auditor agent, and a PostToolUse hook that blocks pubspec edits breaking the layer rules.

The skills and the agent carry workflows only. The architecture itself lives in `references/ffca/`, which is the single source of truth. It is a byte mirror of the FFCA section of VGV Engineering, one file per page, regenerated by `scripts/sync_reference.dart`. Never edit its content to match a skill. Change the upstream page, re-sync, then fix the skills that drifted.

The only code is the Dart layer validator under `scripts/` and the bash hook wrapper that calls it.

## Repository Structure

```text
.mcp.json                  # MCP server configuration (Very Good CLI)
.claude-plugin/
  plugin.json              # Plugin manifest (name, version, description, keywords)
agents/
  ffca-layer-auditor.md    # Read-only architecture auditor subagent
config/
  cspell.json              # Spell check dictionary
  custom.markdownlint.jsonc  # markdownlint rules
hooks/
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add verygoodopensource/vgv-ffca-plugin/AGENTS.md@sha256:230270abfb32fa4a

The line at the top of this page pins the label git:20261021.79ecd2a, 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_mzptugnit2bgemp6.svg)](https://markdownregistry.com/a/art_mzptugnit2bgemp6)

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

Versions

The registry has recorded 5 versions of this file, between Sep 29, 2026 and Oct 21, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20261021.79ecd2a latest2026-10-21 79ecd2a 8,177 BA view · diff
git:20261014.4b1ff472026-10-14 4b1ff47 8,013 BA view · diff
git:20261001.0f5d29e2026-10-01 0f5d29e 7,941 BA view · diff
git:20260929.ceab7142026-09-29 ceab714 7,622 BA view · diff
git:20260929.6d2f9862026-09-29 6d2f986 6,876 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 (8177 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

verygoodopensource/vgv-ffca-plugin · 6 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mzptugnit2bgemp6
GET https://markdownregistry.com/api/v1/resolve?ref=verygoodopensource/vgv-ffca-plugin/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/230270abfb32fa4a3ee71ebb8ddab2075db7d875cb854f4c63f0a7d6abba7f7d

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 verygoodopensource/vgv-ffca-plugin

CLAUDE.md CLAUDE.md file
verygoodopensource/vgv-ffca-plugin · CLAUDE.md
git:20261021.79ecd2a · audit A · 6 stars
ffca-architecture SKILL.md skill
verygoodopensource/vgv-ffca-plugin · skills/ffca-architecture/SKILL.md · Feature-First Clean Architecture (FFCA) orientation for Flutter monorepos: where code lives, layer boundaries…
git:20260929.ceab714 · audit A · 6 stars
ffca-audit SKILL.md skill
verygoodopensource/vgv-ffca-plugin · skills/ffca-audit/SKILL.md · Audit an FFCA monorepo for architecture compliance: mechanical layer, naming, and cycle checks plus a qualitative…
git:20261021.79ecd2a · audit A · 6 stars
ffca-cross-feature SKILL.md skill
verygoodopensource/vgv-ffca-plugin · skills/ffca-cross-feature/SKILL.md · Cross-feature dependencies in FFCA: the Summary pattern, Queries that combine repositories, sharing widgets between…
git:20260929.ceab714 · audit A · 6 stars
ffca-feature SKILL.md skill
verygoodopensource/vgv-ffca-plugin · skills/ffca-feature/SKILL.md · Scaffold and extend FFCA features: the three-package domain, data, and presentation structure, models, repositories…
git:20261001.0f5d29e · audit A · 6 stars
ffca-routing SKILL.md skill
verygoodopensource/vgv-ffca-plugin · skills/ffca-routing/SKILL.md · Routing and navigation for FFCA monorepos: callback injection, go_router_builder typed routes, splitting the routing…
git:20260929.ceab714 · audit A · 6 stars

Every file in verygoodopensource/vgv-ffca-plugin

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261015.0e1f0bf · audit A · 352,890 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 302,424 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261011.412347a · audit A · 284,510 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 193,096 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 170,980 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261011.5d64745 · audit A · 136,966 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 129,649 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 113,780 stars

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