clean-oop-architecture SKILL.md skillA

clean-oop-architecture from furkantokkan/agent-foundry is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add furkantokkan/agent-foundry/clean-oop-architecture@git:20261002.6707fe1

Pins git:20261002.6707fe1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
furkantokkan/agent-foundry
Path
plugins/agent-foundry/skills/clean-oop-architecture/SKILL.md
Versions recorded
3
Latest version
git:20261002.6707fe1, committed Oct 2, 2026
First version recorded
Sep 7, 2026
Size
4,018 bytes
Repository stars
11
License
MIT

Use when designing, implementing, refactoring, or reviewing object-oriented code with SOLID, Clean Code, design patterns, dependency injection, ServiceLocator, Onity, testability, code smells, naming, class/function boundaries, Unity C# architecture, maintainability concerns, hidden assumptions, overengineering, surgical-change discipline, or goal-driven verification.

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

# Clean OOP Architecture

Use this skill for code quality decisions that go beyond syntax: boundaries,
responsibilities, coupling, cohesion, naming, refactoring, and testability.

## Core Principle

Prefer code that is easy to change safely:

- One clear reason to change per class or module.
- Behavior grouped by responsibility, not by convenience.
- Dependencies point inward toward stable abstractions.
- Domain logic is testable without Unity scenes, Firebase, network, or UI.
- Framework code adapts the domain; it does not become the domain.

## First Read

Before changing code, inspect:

1. Existing project conventions.
2. The target class/module and direct collaborators.
3. Tests around the behavior.
4. Composition root / dependency injection setup if present.
5. Any ADR, design doc, or task file that names the pattern.

## SOLID Checks

- **SRP**: Does this class have one reason to change?
- **OCP**: Can likely variants be added without editing core logic?
- **LSP**: Can subclasses/implementations replace the base contract safely?
- **ISP**: Are interfaces small and role-specific?
- **DIP**: Does high-level policy depend on abstractions, not concrete services?
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add furkantokkan/agent-foundry/clean-oop-architecture@sha256:9f82981104548fd0

The line at the top of this page pins the label git:20261002.6707fe1, 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_qz2awd5bbu326xj3.svg)](https://markdownregistry.com/a/art_qz2awd5bbu326xj3)

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

Versions

The registry has recorded 3 versions of this file, between Sep 7, 2026 and Oct 2, 2026, about one every 13 days.

versioncommittedcommitsizeaudit
git:20261002.6707fe1 latest2026-10-02 6707fe1 4,018 BA view · diff
git:20260924.48323232026-09-24 4832323 3,824 BA view · diff
git:20260907.501dbca2026-09-07 501dbca 3,809 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4018 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

furkantokkan/agent-foundry · 11 stars · license MIT · pushed 2026-10-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_qz2awd5bbu326xj3
GET https://markdownregistry.com/api/v1/resolve?ref=furkantokkan/agent-foundry/clean-oop-architecture
GET https://markdownregistry.com/api/v1/blob/9f82981104548fd0537ca901de7b1b58ccabd73025149844ca3bed393f15018e

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: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from furkantokkan/agent-foundry

adaptive-skills SKILL.md skill
furkantokkan/agent-foundry · plugins/agent-foundry/skills/adaptive-skills/SKILL.md · Use when a task may span multiple personal skills and Codex should choose the smallest relevant skill set across Unity…
git:20261008.93495d3 · audit A · 11 stars
adopt SKILL.md skill
furkantokkan/agent-foundry · plugins/agent-foundry/skills/adopt/SKILL.md · Brownfield onboarding — audits existing project artifacts for template format compliance (not just existence)…
git:20260907.501dbca · audit A · 11 stars
agent-orchestration SKILL.md skill
furkantokkan/agent-foundry · plugins/agent-foundry/skills/agent-orchestration/SKILL.md · Coordinate game, Unity, web, SaaS, and tooling work through one orchestration workflow across Claude and Codex. Resolve…
git:20261008.792bea5 · audit A · 11 stars
architecture-decision SKILL.md skill
furkantokkan/agent-foundry · plugins/agent-foundry/skills/architecture-decision/SKILL.md · Creates an Architecture Decision Record (ADR) documenting a significant technical decision, its context, alternatives…
git:20260924.4832323 · audit A · 11 stars
architecture-review SKILL.md skill
furkantokkan/agent-foundry · plugins/agent-foundry/skills/architecture-review/SKILL.md · Validates completeness and consistency of the project architecture against all GDDs. Builds a traceability matrix…
git:20260907.501dbca · audit A · 11 stars
art-bible SKILL.md skill
furkantokkan/agent-foundry · plugins/agent-foundry/skills/art-bible/SKILL.md · Guided, section-by-section Art Bible authoring. Creates the visual identity specification that gates all asset…
git:20260907.501dbca · audit A · 11 stars
asset-audit SKILL.md skill
furkantokkan/agent-foundry · plugins/agent-foundry/skills/asset-audit/SKILL.md · Audits game assets for compliance with naming conventions, file size budgets, format standards, and pipeline…
git:20260907.501dbca · audit A · 11 stars
asset-spec SKILL.md skill
furkantokkan/agent-foundry · plugins/agent-foundry/skills/asset-spec/SKILL.md · Generate per-asset visual specifications and AI generation prompts from GDDs, level docs, or character profiles…
git:20260907.501dbca · audit A · 11 stars
balance-check SKILL.md skill
furkantokkan/agent-foundry · plugins/agent-foundry/skills/balance-check/SKILL.md · Analyzes game balance data files, formulas, and configuration to identify outliers, broken progressions, degenerate…
git:20260907.501dbca · audit A · 11 stars
brainstorm SKILL.md skill
furkantokkan/agent-foundry · plugins/agent-foundry/skills/brainstorm/SKILL.md · Guided game concept ideation — from zero idea to a structured game concept document. Uses professional studio ideation…
git:20260907.501dbca · audit A · 11 stars
bug-report SKILL.md skill
furkantokkan/agent-foundry · plugins/agent-foundry/skills/bug-report/SKILL.md · Creates a structured bug report from a description, or analyzes code to identify potential bugs. Ensures every bug…
git:20260907.501dbca · audit A · 11 stars
bug-triage SKILL.md skill
furkantokkan/agent-foundry · plugins/agent-foundry/skills/bug-triage/SKILL.md · Read all open bugs in production/qa/bugs/, re-evaluate priority vs. severity, assign to sprints, surface systemic…
git:20260907.501dbca · audit A · 11 stars

Every file in furkantokkan/agent-foundry

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