architecture Cursor ruleA

architecture from coddy-project/coddy-agent is a Cursor rule: instructions the Cursor agent follows in that repo.

Install it, pinned
mdr add coddy-project/coddy-agent/.cursor/rules/architecture.mdc@git:20261004.8e8554b

Pins git:20261004.8e8554b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
Cursor rule
Repository
coddy-project/coddy-agent
Path
.cursor/rules/architecture.mdc
Versions recorded
6
Latest version
git:20261004.8e8554b, committed Oct 4, 2026
First version recorded
May 13, 2026
Size
3,287 bytes
Repository stars
178
License
MIT

Layers and dependency direction for Coddy Agent.

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

# Architecture

**Coddy** is a Go CLI and ACP harness. Keep dependencies flowing **inward**: higher layers orchestrate lower ones; shared types stay shallow.

## Rough layers (low to high)

1. **`internal/version`**, **`internal/logger`**, small shared helpers - minimal inward imports.
2. **`internal/config`** - configuration structs and loading.
3. **`internal/session`**, **`internal/llm`**, **`internal/prompts`**, **`internal/bgtask`** - runtime state, model access, and the background task pool (**`internal/bgtask`** imports only **`internal/platform`**; nothing below it may import back).
4. **`internal/tools`**, **`internal/permission`**, **`internal/skills`**, **`internal/subagents`**, **`internal/hooks`** - capabilities and policies (**`internal/subagents`** produces immutable definitions and pure trust / tool-set decisions, **`internal/hooks`** loads hook definitions and runs hook processes with pure outcome merging; **`internal/agent`** applies both).
5. **`internal/agent`** - ReAct-style loop assembling the above.
6. **`internal/acp`** - ACP protocol server on top of the agent and session manager.
7. **`cmd/coddy`** - CLI entrypoints and wiring.

## Optional build tags
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add coddy-project/coddy-agent/.cursor/rules/architecture.mdc@sha256:cab5ada488313c3e

The line at the top of this page pins the label git:20261004.8e8554b, 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_w656glx427m5wxpl.svg)](https://markdownregistry.com/a/art_w656glx427m5wxpl)

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

Versions

The registry has recorded 6 versions of this file, between May 13, 2026 and Oct 4, 2026, about one every 29 days.

versioncommittedcommitsizeaudit
git:20261004.8e8554b latest2026-10-04 8e8554b 3,287 BA view · diff
git:20260912.c2d53a82026-09-12 c2d53a8 3,304 BA view · diff
git:20260906.42f24c52026-09-06 42f24c5 3,291 BA view · diff
git:20260903.89ab0bd2026-09-03 89ab0bd 3,174 BA view · diff
git:20260729.fcd5fdd2026-07-29 fcd5fdd 3,023 BA view · diff
git:20260513.fcf00cc2026-05-13 fcf00cc 2,878 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 (3287 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

coddy-project/coddy-agent · 178 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_w656glx427m5wxpl
GET https://markdownregistry.com/api/v1/resolve?ref=coddy-project/coddy-agent/.cursor/rules/architecture.mdc
GET https://markdownregistry.com/api/v1/blob/cab5ada488313c3e976c911c89a00bc065e1bb239caecce4227f50c95949aba0

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: Cursor rules vs AGENTS.md · which agent file does what.

More from coddy-project/coddy-agent

acp-protocol Cursor rule
coddy-project/coddy-agent · .cursor/rules/acp-protocol.mdc · ACP session readiness, notifications, and wire compatibility
git:20261004.4bb7222 · audit A · 178 stars
agent-model-choice Cursor rule
coddy-project/coddy-agent · .cursor/rules/agent-model-choice.mdc · User-owned model choice and settings notices
git:20261005.d31d9be · audit A · 178 stars
api-layer Cursor rule
coddy-project/coddy-agent · .cursor/rules/api-layer.mdc · Optional HTTP gateway, OpenAPI spec source of truth
git:20261007.7a61267 · audit A · 178 stars
build-tags Cursor rule
coddy-project/coddy-agent · .cursor/rules/build-tags.mdc · The shipped build tag set is spelled in several places that move together
git:20261015.d5a3cb8 · audit A · 178 stars
code-style Cursor rule
coddy-project/coddy-agent · .cursor/rules/code-style.mdc · Formatting, lint, comments language
git:20261013.10eb20e · audit A · 178 stars
config-roundtrip Cursor rule
coddy-project/coddy-agent · .cursor/rules/config-roundtrip.mdc · Lossless and concurrent configuration round trips
git:20261004.4bb7222 · audit A · 178 stars
console-tui Cursor rule
coddy-project/coddy-agent · .cursor/rules/console-tui.mdc · Console TUI rendering, local shell, and question behavior
git:20261004.4bb7222 · audit A · 178 stars
core-modules Cursor rule
coddy-project/coddy-agent · .cursor/rules/core-modules.mdc · Main internal packages at a glance
git:20261019.856be9a · audit A · 178 stars
docs-translation Cursor rule
coddy-project/coddy-agent · .cursor/rules/docs-translation.mdc · The Russian documentation tree (docs/ru), what moves with an English page, the stamp, and the writing rules for Russian…
git:20261018.bc36d0a · audit A · 178 stars
gateway Cursor rule
coddy-project/coddy-agent · .cursor/rules/gateway.mdc · Messenger gateway architecture, session store, and the Telegram and Pachca adapter conventions
git:20261020.4665378 · audit A · 178 stars
implementation-order Cursor rule
coddy-project/coddy-agent · .cursor/rules/implementation-order.mdc · Layered implementation order (cake model)
git:20261004.8e8554b · audit A · 178 stars
llm-streaming Cursor rule
coddy-project/coddy-agent · .cursor/rules/llm-streaming.mdc · Streaming completion safety and protocol termination
git:20261004.4bb7222 · audit A · 178 stars

Every file in coddy-project/coddy-agent

Other files named architecture

architecture SKILL.md skill
sickn33/agentic-awesome-skills · plugins/agentic-awesome-skills-claude/skills/architecture/SKILL.md · Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when…
git:20260708.a07936c · audit A · 48,329 stars
architecture SKILL.md skill
davepoon/buildwithclaude · plugins/cc-best/skills/architecture/SKILL.md · Architecture design skill with ADR records, system design checklists, scalability assessment, and architecture patterns
git:20260307.6b5172a · audit A · 3,660 stars
architecture Cursor rule
sipyourdrink-ltd/bernstein · .cursor/rules/architecture.mdc · Architecture (entry points)
git:20260901.719ea1e · audit A · 1,310 stars
architecture Cursor rule
autonomous-ai/lampos · .cursor/rules/architecture.mdc · Architecture and coding conventions for AI Lamp OpenClaw
git:20260324.7a91f3b · audit A · 483 stars
architecture Cursor rule
autonomous-ai/autonomous-os · .cursor/rules/architecture.mdc · Architecture and coding conventions for AI Lamp OpenClaw
git:20260324.7a91f3b · audit A · 479 stars
architecture Cursor rule
autonomous-ai/physical-ai-operating-system · .cursor/rules/architecture.mdc · Architecture and coding conventions for AI Lamp OpenClaw
git:20260324.7a91f3b · audit A · 479 stars
architecture SKILL.md skill
hdl-tools/digital-chip-design-agents · plugins/architecture/skills/architecture/SKILL.md · Microarchitecture exploration, PPA estimation, risk assessment, and architecture sign-off for digital chip design. Use…
v1.0.0 · audit A · 220 stars
architecture SKILL.md skill
techygarg/lattice · skills/architecture/SKILL.md · Enforce architectural rules when generating or modifying code, and validate proposed designs before approval (design…
git:20260903.6d09876 · audit A · 206 stars

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