Skip to content

Instantly share code, notes, and snippets.

@RupertBarrow
Last active March 18, 2026 16:06
Show Gist options
  • Select an option

  • Save RupertBarrow/fb6536acb55d3417198d25212cd57160 to your computer and use it in GitHub Desktop.

Select an option

Save RupertBarrow/fb6536acb55d3417198d25212cd57160 to your computer and use it in GitHub Desktop.
FAB Team Lint Report v1.0.8 — BOOT.md + BOOTSTRAP.md in spec, 32 findings

FAB Team Agent Definition Lint Report

Date: 2026-03-18 17:06 Tool: @rapido-fab/agent-definition-lint v1.0.8 Layers: L1 (structural) + L2 (quality)

New in v1.0.8:

  • BOOT.md and BOOTSTRAP.md added to Agent Definition Spec (sections 8 & 9)
  • BOOT.md recognized as a valid agent file (no longer flagged as unknown)
  • BOOTSTRAP.md presence in a running workspace → 🟡 warning (should be deleted after first run)

Claudia

  • ✅ AGENTS.md, BOOT.md, HEARTBEAT.md, IDENTITY.md, MEMORY.md, USER.md — no issues
# Sev File Rule Message Suggested Decision
1 🟡 MANTRA.md L1-UNKNOWN-DEFINITION-FILE Unknown agent definition file Decide: add to spec or move to team-genetics
2 🟡 SHARED-RAPIDO-VALUES.md L1-UNKNOWN-DEFINITION-FILE Unknown agent definition file Decide: add to spec or move to team-genetics
3 🟡 SOUL.md (L85) L2-ANTIPATTERN-SOUL-EMPLOYEE-HANDBOOK Employee handbook anti-pattern Move CMMI gates to AGENTS.md
4 🟡 TOOLS.md (L57) L1-EMPTY-SECTION Empty section: "Telegram Topics" Remove or populate
5 🟡 TOOLS.md (L88) L2-ANTIPATTERN-TOOLS-AS-AGENTS Operational rules in TOOLS.md — belong in AGENTS.md Move to AGENTS.md

Claudia: 0 errors, 5 warnings


Devdas

  • ✅ AGENTS.md, BOOT.md, IDENTITY.md, TOOLS.md, USER.md — no issues
# Sev File Rule Message Suggested Decision
6 🟡 MANTRA.md L1-UNKNOWN-DEFINITION-FILE Unknown agent definition file Decide: add to spec or move to team-genetics
7 🟡 SHARED-RAPIDO-VALUES.md L1-UNKNOWN-DEFINITION-FILE Unknown agent definition file Decide: add to spec or move to team-genetics
8 🔵 HEARTBEAT.md (L1) L1-EMPTY-SECTION Empty file (title only, no real content)
9 🔴 SOUL.md L1-SOUL-MISSING-SECTION Required section "Role" not found Add ## Role — Senior Developer / Lead Engineer
10 🟡 SOUL.md (L42) L2-VAGUE-LANGUAGE Vague language "appropriate" in rules/boundaries Replace with specific criterion
11 🟡 SOUL.md (L46) L2-ANTIPATTERN-SOUL-EMPLOYEE-HANDBOOK Employee handbook anti-pattern Extract process rules to AGENTS.md

Devdas: 1 error, 4 warnings, 1 info


Archibald

  • ✅ AGENTS.md, BOOT.md, IDENTITY.md, TOOLS.md, USER.md — no issues
# Sev File Rule Message Suggested Decision
12 🟡 MANTRA.md L1-UNKNOWN-DEFINITION-FILE Unknown agent definition file Decide: add to spec or move to team-genetics
13 🟡 SHARED-RAPIDO-VALUES.md L1-UNKNOWN-DEFINITION-FILE Unknown agent definition file Decide: add to spec or move to team-genetics
14 🔵 HEARTBEAT.md (L1) L1-EMPTY-SECTION Empty file (title only, no real content)
15 🔴 SOUL.md L1-SOUL-MISSING-SECTION Required section "Role" not found Add ## Role — Archivist / Content Manager

Archibald: 1 error, 2 warnings, 1 info


Frédéric

  • ✅ AGENTS.md, BOOT.md, IDENTITY.md, MEMORY.md, TOOLS.md, USER.md — no issues
# Sev File Rule Message Suggested Decision
16 🟡 MANTRA.md L1-UNKNOWN-DEFINITION-FILE Unknown agent definition file Decide: add to spec or move to team-genetics
17 🟡 SHARED-RAPIDO-VALUES.md L1-UNKNOWN-DEFINITION-FILE Unknown agent definition file Decide: add to spec or move to team-genetics
18 🔵 HEARTBEAT.md (L1) L1-EMPTY-SECTION Empty file (title only, no real content)
19 🔴 SOUL.md L1-SOUL-MISSING-SECTION Required section "Role" not found Add ## Role — Business Development / Sales
20 🟡 SOUL.md (L76) L2-VAGUE-LANGUAGE Vague language "good" in rules/boundaries Replace with specific criterion
21 🟡 SOUL.md (L45) L2-ANTIPATTERN-SOUL-EMPLOYEE-HANDBOOK Employee handbook anti-pattern Extract process rules to AGENTS.md

Frédéric: 1 error, 4 warnings, 1 info


Salvatore

  • ✅ AGENTS.md, BOOT.md, IDENTITY.md, MEMORY.md, TOOLS.md, USER.md — no issues
# Sev File Rule Message Suggested Decision
22 🟡 MANTRA.md L1-UNKNOWN-DEFINITION-FILE Unknown agent definition file Decide: add to spec or move to team-genetics
23 🟡 PRJ-009-CRUD-TEST-RESULTS.md L1-UNKNOWN-DEFINITION-FILE Work file leaked into workspace Move to project directory
24 🟡 SHARED-RAPIDO-VALUES.md L1-UNKNOWN-DEFINITION-FILE Unknown agent definition file Decide: add to spec or move to team-genetics
25 🔵 HEARTBEAT.md (L1) L1-EMPTY-SECTION Empty file (title only, no real content)
26 🔴 SOUL.md L1-SOUL-MISSING-SECTION Required section "Role" not found Add ## Role — Salesforce Specialist

Salvatore: 1 error, 3 warnings, 1 info


Sylvain

  • ✅ AGENTS.md, BOOT.md, IDENTITY.md, TOOLS.md, USER.md — no issues
# Sev File Rule Message Suggested Decision
27 🟡 MANTRA.md L1-UNKNOWN-DEFINITION-FILE Unknown agent definition file Decide: add to spec or move to team-genetics
28 🟡 SHARED-RAPIDO-VALUES.md L1-UNKNOWN-DEFINITION-FILE Unknown agent definition file Decide: add to spec or move to team-genetics
29 🟡 BOOTSTRAP.md L1-BOOTSTRAP-STILL-EXISTS BOOTSTRAP.md still exists — should be deleted after first run Delete after executing bootstrap ritual
30 🔵 HEARTBEAT.md (L1) L1-EMPTY-SECTION Empty file (title only, no real content)
31 🔴 SOUL.md L1-SOUL-MISSING-SECTION Required section "Role" not found Add ## Role — SysAdmin / DevOps Engineer
32 🟡 SOUL.md (L50) L2-CONTENT-BOUNDARY Environment paths in SOUL.md — should be in TOOLS.md Move paths to TOOLS.md

Sylvain: 1 error, 4 warnings, 1 info


Cross-Team Summary

Pat Issue Affected Sev Suggested Decision
A Missing "Role" section in SOUL.md 5/6 (all except Claudia) 🔴 Add Role to every SOUL.md ✅ confirmed
B Empty HEARTBEAT.md (placeholder files) 5/6 (all except Claudia) 🔵
C SOUL.md employee handbook anti-pattern 3/6 (Claudia, Devdas, Frédéric) 🟡 Move operational rules/gates to AGENTS.md
D Environment paths in SOUL.md 1/6 (Sylvain) 🟡 Move to TOOLS.md
E Vague language in rules/boundaries 2/6 (Devdas, Frédéric) 🟡 Replace with specific measurable criteria
F Unknown: MANTRA.md 6/6 🟡 Add to spec or move to team-genetics injection
G Unknown: SHARED-RAPIDO-VALUES.md 6/6 🟡 Add to spec or move to team-genetics injection
H Work file in workspace (PRJ-009-CRUD-TEST-RESULTS.md) 1/6 (Salvatore) 🟡 Move to project directory
I BOOTSTRAP.md not deleted after first run 1/6 (Sylvain) 🟡 Delete after bootstrap

Grand total: 5 errors, 22 warnings, 5 info across 6 agents (32 visible findings)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment