# DevTrend — Full Agentic AI Rules & Architecture Reference (llms-full.txt)

> DevTrend (https://devtrend.de/) — Free Trend Analyzer and Instruction Builder for Agentic AI Development. Just select agentic AI development category, analyze trending GitHub projects and create appropriate agentic AI rules.

This document (`llms-full.txt`) contains the complete, unabridged catalog of all 6 Architectural Guardrail Presets and all 80 curated GitHub repository directives across 8 Agentic AI & Software Engineering categories. AI coding assistants can ingest this file directly to generate deterministic `AGENTS.md`, `CLAUDE.md`, `.cursorrules`, or `stack.json` files.

- **Canonical Web App**: https://devtrend.de/
- **Summary Index**: https://devtrend.de/llms.txt
- **Full Reference**: https://devtrend.de/llms-full.txt
- **Live JSON Dataset**: https://devtrend.de/data/trending.json
- **Ranking History JSON**: https://devtrend.de/data/ranking-history.json

---

## Part 1: Architectural & Engineering Guardrail Presets

### 1. Strict Type Safety (`rule-strict-typing`)
- **Summary**: TypeScript strict / Pydantic v2 / End-to-End Types
- **Agent Directive**: Enforce strict static typing across all modules (e.g., `strict: true` in tsconfig, explicit return types, Pydantic v2 models in Python, zero `any` or untyped dictionaries).

### 2. Hexagonal / Clean Architecture (`rule-clean-arch`)
- **Summary**: Domain-driven boundaries & dependency inversion
- **Agent Directive**: Separate Domain, Application Use-Cases, and Infrastructure Adapters. Domain logic must never import framework or database drivers directly.

### 3. TDD & Automated Tests (`rule-tdd`)
- **Summary**: Unit + Integration tests required before completion
- **Agent Directive**: Follow Test-Driven Development (TDD). Write deterministic unit and integration tests for every business rule and API endpoint before marking tasks complete.

### 4. EU Sovereign & GDPR Privacy (`rule-eu-gdpr`)
- **Summary**: Zero unauthorized telemetry, PII minimization
- **Agent Directive**: Comply with EU GDPR & data sovereignty standards: minimize PII storage, support self-hosted/EU endpoints, and avoid third-party trackers without explicit consent.

### 5. Contract-First OpenAPI (`rule-openapi`)
- **Summary**: Schema-driven REST/RPC interfaces
- **Agent Directive**: Design API contracts and schemas (OpenAPI 3.1 / JSON Schema / Zod) first before implementing route handlers or frontend consumers.

### 6. OWASP Zero-Trust Guardrails (`rule-security-owasp`)
- **Summary**: Parameterized queries, input sanitization, no secrets in code
- **Agent Directive**: Enforce OWASP Top-10 mitigations: parameterized queries only, strict input validation at boundaries, least-privilege tokens, and zero hardcoded secrets.

---

## Part 2: Complete Category & Repository Directives (8 Categories, 80 Projects)

### Category 1: Agent Rules (`agent-rules`)
*Top 10 community & official agentic coding instruction repositories*

1. **Awesome CursorRules** (`PatrickJS/awesome-cursorrules`)
   - **URL**: https://github.com/PatrickJS/awesome-cursorrules
   - **Description**: Curated collection of `.cursorrules` and agent instructions for dozens of stacks.
   - **Agent Rule**: Provide explicit persona context, directory layout map, and concise Do/Don't rules at the top of the instructions file.

2. **Claude Code & CLAUDE.md** (`anthropics/claude-code`)
   - **URL**: https://github.com/anthropics/claude-code
   - **Description**: Anthropic's agentic coding tool and official `CLAUDE.md` repository memory conventions.
   - **Agent Rule**: Include exact build, lint, and single-test execution commands (`npm test -- path/to/test`) so the agent can self-verify changes.

3. **OpenAI Codex CLI & AGENTS.md** (`openai/codex`)
   - **URL**: https://github.com/openai/codex
   - **Description**: OpenAI's lightweight coding agent utilizing hierarchical `AGENTS.md` instructions.
   - **Agent Rule**: Support hierarchical `AGENTS.md` files (root-level architecture + package-scoped overrides) and deterministic verification steps.

4. **AGENTS.md Open Standard** (`agentsmd/agents.md`)
   - **URL**: https://github.com/agentsmd/agents.md
   - **Description**: Vendor-neutral open standard `AGENTS.md` format for guiding AI coding assistants.
   - **Agent Rule**: Structure `AGENTS.md` with clear Markdown headings: `# Overview`, `## Stack`, `## Commands`, `## Style`, and `## Verification`.

5. **Gemini CLI & GEMINI.md** (`google-gemini/gemini-cli`)
   - **URL**: https://github.com/google-gemini/gemini-cli
   - **Description**: Google Gemini terminal agent supporting `GEMINI.md` and `AGENTS.md` workspace context.
   - **Agent Rule**: Keep context files token-efficient, factual, and free of ambiguous prose; prefer concrete code patterns over abstract advice.

6. **Vercel AI SDK Agent Rules** (`vercel/ai`)
   - **URL**: https://github.com/vercel/ai
   - **Description**: Official rules for building streaming AI applications and tool-calling workflows.
   - **Agent Rule**: Use `streamText`/`generateObject` with Zod schemas and enforce strict separation between server AI routes and client UI hooks.

7. **Full-Stack TypeScript Strict** (`total-typescript/ts-reset`)
   - **URL**: https://github.com/total-typescript/ts-reset
   - **Description**: Strict TypeScript agent guardrails eliminating unsafe `any`, `as` casts, and runtime surprises.
   - **Agent Rule**: Forbid `any` and unsafe `as` type assertions; use discriminated unions, `unknown` narrowing, and Zod runtime parsing at I/O boundaries.

8. **FastAPI Clean Arch Rules** (`zhanymkanov/fastapi-best-practices`)
   - **URL**: https://github.com/zhanymkanov/fastapi-best-practices
   - **Description**: Production-hardened agent instructions for domain-driven Python & FastAPI services.
   - **Agent Rule**: Organize backend modules by domain feature (`src/<domain>/router.py`, `schemas.py`, `service.py`, `models.py`) rather than file type.

9. **OWASP Secure Coding** (`OWASP/CheatSheetSeries`)
   - **URL**: https://github.com/OWASP/CheatSheetSeries
   - **Description**: Security-first `AGENTS.md` guardrails preventing SSRF, SQLi, XSS, and secret leakage.
   - **Agent Rule**: Never commit secrets or `.env` files; validate all external inputs, sanitize HTML rendering, and enforce CSRF/CORS policies.

10. **Reproducible DevContainer** (`devcontainers/spec`)
    - **URL**: https://github.com/devcontainers/spec
    - **Description**: Agentic workflow instructions for isolated, reproducible Docker and DevContainer environments.
    - **Agent Rule**: Ensure all dependencies, CLI tools, and database services can be booted headlessly via a single command in CI and local sandboxes.

---

### Category 2: Architecture Concepts & Patterns (`architecture-concepts-patterns`)
*Top 10 software architecture, DDD, Clean Architecture & system design blueprints*

1. **System Design Primer** (`donnemartin/system-design-primer`)
   - **URL**: https://github.com/donnemartin/system-design-primer
   - **Description**: Learn how to design large-scale distributed systems with architectural trade-offs and patterns.
   - **Agent Rule**: Design stateless horizontal services, explicit caching tiers, idempotent APIs, and graceful degradation for external dependencies.

2. **Node.js Best Practices** (`goldbergyoni/nodebestpractices`)
   - **URL**: https://github.com/goldbergyoni/nodebestpractices
   - **Description**: Comprehensive guide to modular 3-tier component architecture and production error handling.
   - **Agent Rule**: Structure code by self-contained domain components (`entry-points`, `domain`, `data-access`) and throw typed operational AppErrors.

3. **Java Design Patterns** (`iluwatar/java-design-patterns`)
   - **URL**: https://github.com/iluwatar/java-design-patterns
   - **Description**: Battle-tested GoF, enterprise, and cloud architectural design patterns implemented cleanly.
   - **Agent Rule**: Prefer composition over inheritance, program to explicit interfaces, and apply Factory, Strategy, or Adapter patterns to decouple modules.

4. **Bulletproof React** (`alan2207/bulletproof-react`)
   - **URL**: https://github.com/alan2207/bulletproof-react
   - **Description**: Simple, scalable, and powerful feature-based architecture for production frontend applications.
   - **Agent Rule**: Enforce unidirectional codebase imports (`shared -> features -> app`); features must never cross-import internals from other features.

5. **Clean Architecture (.NET)** (`jasontaylordev/CleanArchitecture`)
   - **URL**: https://github.com/jasontaylordev/CleanArchitecture
   - **Description**: Clean Architecture solution template separating Domain, Application, Infrastructure, and Web UI.
   - **Agent Rule**: Enforce strict inward dependency rules: `Domain` has zero external dependencies; `Application` defines use-cases and ports via CQRS.

6. **Domain-Driven Hexagon** (`Sairyss/domain-driven-hexagon`)
   - **URL**: https://github.com/Sairyss/domain-driven-hexagon
   - **Description**: Guide on Domain-Driven Design, Hexagonal (Ports & Adapters) Architecture, CQRS, and SOLID.
   - **Agent Rule**: Model Aggregates, Value Objects, and Domain Services explicitly; connect HTTP/DB drivers strictly through inbound/outbound Ports & Adapters.

7. **Modular Monolith with DDD** (`kgrzybek/modular-monolith-with-ddd`)
   - **URL**: https://github.com/kgrzybek/modular-monolith-with-ddd
   - **Description**: Full Modular Monolith application with Domain-Driven Design bounded contexts and outbox messaging.
   - **Agent Rule**: Isolate Bounded Contexts in separate modules communicating only via public contracts or Transactional Outbox integration events.

8. **Awesome Software Architecture** (`mehdihadeli/awesome-software-architecture`)
   - **URL**: https://github.com/mehdihadeli/awesome-software-architecture
   - **Description**: Curated catalog of software architecture principles, ADR templates, Event Sourcing, and CQRS.
   - **Agent Rule**: Document major architectural decisions in `docs/adr/` (Architecture Decision Records) and keep read/write paths clearly separated.

9. **Go Clean Architecture Template** (`evrone/go-clean-template`)
   - **URL**: https://github.com/evrone/go-clean-template
   - **Description**: Clean Architecture template for Golang services separating entities, usecases, and controllers.
   - **Agent Rule**: Keep `internal/entity` and `internal/usecase` framework-agnostic and inject repository/RPC interfaces via constructors.

10. **Cosmic Python (DDD)** (`cosmicpython/code`)
    - **URL**: https://github.com/cosmicpython/code
    - **Description**: Architecture Patterns with Python: Unit of