Django 5 & Ninja / DRF AGENTS.md Generator | Free & Offline

Production-grade architectural rulebook for Django 5 & Ninja / DRF. Engineered to eliminate LLM hallucinations, enforce strict deterministic conventions, and prevent architectural drift across Cursor IDE, Claude Code CLI, and autonomous multi-agent pipelines.

Target Path
AGENTS.md
Execution Scope
Multi-Agent Root Invariants
Specification Format
Agent Standard (.md)
AI Tool Support
Antigravity, Codex & Windsurf
02 / DRIFT ANALYSIS & VALUE PROPOSITION

Failure Patterns Prevented for Django 5 & Ninja / DRF

Without This Rule (Default LLM Behavior)Vulnerable

Django 5 introduces asynchronous ORM methods, generated model fields, and modern API patterns via Django Ninja and DRF. LLMs constantly hallucinate synchronous N+1 queries inside async views, unparameterized raw SQL, and unmanaged migration modifications.

Hallucination Symptoms
  • Invokes deprecated or removed APIs from older model training weights
  • Generates conflicting configuration files and invalid imports
  • Silently drops type-safety, boundaries, or transaction isolation
With This Rule (Guaranteed Invariants)Deterministic
Use asynchronous ORM operations (aget(), acreate(), afirst()) inside async def view handlers.
Prevent N+1 query catastrophes: always apply select_related() for ForeignKey/OneToOne and prefetch_related() for ManyToMany/reverse relationships.
Enforce Django Ninja schemas or DRF serializers with explicit field typing; never return raw unvalidated model instances.
Never alter existing committed migration files; generate new sequential migrations via python manage.py makemigrations.
Leverage Django 5 GeneratedField for computed database columns rather than redundant model save() recalculations.
03 / VERIFIED CODE PATTERNS

Code Standards: Anti-Pattern vs Verified Implementation

Discouraged Anti-Pattern
# Discouraged: Synchronous blocking query inside async context & N+1 queries
@router.get("/articles/{article_id}")
async def get_article(request, article_id: int):
    article = Article.objects.get(id=article_id)  # Synchronous blocking call!
    return {"id": article.id, "title": article.title, "author": article.author.username}  # N+1 DB hit!
Verified Production Standard
from ninja import Router, Schema
from django.shortcuts import aget_object_or_404
from .models import Article

router = Router()

class ArticleOut(Schema):
    id: int
    title: str
    author_name: str

@router.get("/articles/{article_id}", response=ArticleOut)
async def get_article(request, article_id: int):
    # Asynchronous fetch with joined relationship preventing N+1
    article = await Article.objects.select_related("author").aget(id=article_id)
    return {
        "id": article.id,
        "title": article.title,
        "author_name": article.author.username,
    }
04 / REPOSITORY PLACEMENT & 3-STEP TERMINAL INSTALLATION

How to Install Django 5 & Ninja / DRF AGENTS.md Multi-Agent Rules via Terminal

1

Step 1: Open Project Directory & Verify Target Placement

Open your terminal and navigate to your project root folder where the AGENTS.md file will reside. Ensure the file is placed at the exact path below relative to your project root so the AI engine automatically loads it:

AGENTS.md
2

Step 2: Fetch Rule File via Terminal Command

Run curl, PowerShell, or wget to stream the rule directly from the DevScratchpad raw API endpoint and write it to AGENTS.md:

Terminal One-Liner Install

Run directly in your project root to stream and write this rule file with one command.

Raw API Stream
$curl -fsSL "https://www.devscratchpad.tech/api/raw/agents-md/python-django" -o "AGENTS.md"
3

Step 3: Verify and Activate with AI Agent

Launch your AI coding assistant (Antigravity, Codex & Windsurf). The assistant will automatically discover AGENTS.md in your repository and apply the architectural guardrails, type constraints, and verification protocols during code generation.

05 / ROUTE DIRECTORY & CROSS-TOOLING
Format Pillar HubComprehensive Manual

AGENTS.md Multi-Agent System Protocol Directory

Inspect the complete specification manual, glob patterns, directory rules, and all available presets in our central directory.

/agents-md Directory
06 / FREQUENTLY ASKED QUESTIONS

Technical FAQ: Django 5 & Ninja / DRF AI Rulebooks

Does this enforce Django 5 async ORM conventions?

Yes, it guides the model to use aget(), afilter(), and acreate() in async view functions.

Can this be used with Django REST Framework or Django Ninja?

Yes, it supports both DRF serializers and modern Pydantic-powered Django Ninja endpoints.