faidd CLAUDE.md

A repository instruction guide for faidd/faidd, covering coding practices, agent behavior, monorepo work, and keeping Rust and TypeScript code synchronized. A monorepo is one repository containing multiple related projects.

In plain words
What is it for?
Guiding work in the faidd/faidd repository, including package management, cross-package tasks, and updates that affect generated Rust and TypeScript types.
Why use it?
It gives coding agents consistent project rules and identifies how shared schemas should stay aligned across both programming languages.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/faidd/faidd/claude-md
Clone the repo
git clone --depth 1 https://github.com/faidd/faidd
Per session 549 This file is loaded in full into every session.
When invoked 549 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00549 $0.00549
Opus 5 $0.00275 $0.00275
Sonnet 5 $0.00110 $0.00110
Haiku 4.5 $0.00055 $0.00055

Measured 2d ago against content hash 1bbfc60e1a22, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

faidd CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 39 lines

How it starts

The opening of the file, as written. The whole thing — 39 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Claude, Cursor & Cortex Mindset (CLAUDE.md)

This document provides the high-context "System Identity" for Claude-based agents (Antigravity, Cursor, etc.) working on FAIDD. Use this as a permanent memory injection for architectural and behavioral alignment.

🧠 Technical Mindset: "The Guard"

You are not just a coder; you are an engineer helping build a Sovereign Security System. Your tone must be precise, your code must be robust, and your awareness of security boundaries must be absolute.

🛠️ Technical Patterns & Standards

Monorepo Orchestration

  • pnpm: Always use pnpm for package management.
  • Turborepo: Utilize turbo run <task> for cross-package operations.
  • Filtering: Use --filter to isolate operations to specific packages (e.g., pnpm --filter @faidd/cli dev).

Cross-Language Synchronization (Rust ↔ TS)

  • Truth Source: core/schemas contains the logic.
  • TS Generation: Use json-schema-to-typescript in core/schemas.
  • Rust Generation: Use serde and code generators to derive structs.
  • Sync Rule: If you change a schema, you MUST trigger the build for both TS and Rust types immediately.

Rust Implementation Guidelines

  • Zero-Unsafe: No unsafe blocks are allowed unless explicitly justified in the architecture spec.
  • Error Handling: Use anyhow for applications (CLI/Dashboard) and thiserror for library components.
  • Asynchrony: Use tokio as the default runtime.

🚫 Architectural Taboos

  • NO Circular Dependencies: core should never depend on tools.
  • NO Direct _faidd/ Writes: Writing to _faidd/ manually is a violation. All writes must go through the Ledger or Manifest services in core/logic.
  • NO Global State: Use dependency injection or service-based architectures.

⚡ Quick Reference

  • Root Build: pnpm build
  • CLI Development: pnpm --filter @faidd/cli dev
  • CUI Build: cargo build -p faidd-cui
  • Types Sync: pnpm --filter @faidd/schemas build

Read the full file on GitHub · 39 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 39 lines · 549 tokens per session scan A 1bbfc60e1a22

Subscribe to this mod's changes

faidd CLAUDE.md is an instructions file published in the GitHub repository faidd/faidd (11 stars, last pushed 6mo ago), licensed Apache-2.0. It adds 549 tokens to every session, about $0.0027 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories

vibe-coding-prompt-template backend.instructions.md

Instructions for KhazP/vibe-coding-prompt-template: Read AGENTS.md, agentdocs/techstack.md, and agentdocs/codepatterns.md.

KhazP/vibe-coding-prompt-template · 139 tokens

wisp-science AGENTS.md

AGENTS.md instructions for xuzhougeng/wisp-science, covering agents.md, project orientation, repository layout, engineering rules and verification commands.

xuzhougeng/wisp-science · 2,195 tokens

Cerebro AGENTS.md

Instructions for AgenticFirst/Cerebro, covering cerebro — agent context, read before touching integrations, project layout, conventions a fresh agent would otherwise miss and running locally.

AgenticFirst/Cerebro · 1,287 tokens

tabularis CLAUDE.md

Claude Code instructions for TabularisDB/tabularis, a project described as: Open-source desktop SQL workspace for PostgreSQL, MySQL/MariaDB, SQLite and 15+ more databases like DuckDB, ClickHouse, Redis and Firestore. Built-in MCP server for Claude, Cursor and Devin, SQL notebooks and visual EXPLAIN.

TabularisDB/tabularis · 3 tokens

claude-code-orchestration-template AGENTS.md

AGENTS.md instructions for jeroromano/claude-code-orchestration-template, covering agents.md, what this repository is, map, working rules and validation.

jeroromano/claude-code-orchestration-template · 631 tokens

ai-auto-work CLAUDE.md

Claude Code instructions for chaohong-ai/ai-auto-work, covering gamemaker - ai native 游戏创作平台, 项目简介, ai 工作目录约定 and 按需加载(不默认装载).

chaohong-ai/ai-auto-work · 1,166 tokens