Project AGENTS.md

from praisonaiagents import Agent

agent = Agent(
    name="Dev",
    instructions="Help with coding tasks",
)

agent.start("How should I structure new modules in this project?")

​

How It Works

​

Auto-Discovery

​

Quick Start

# Project Context

## Tech Stack
- Python 3.12, FastAPI, SQLAlchemy
- Tests with pytest; coverage >= 90%

## Style
- PEP 8; type hints everywhere; docstrings for public APIs

## Do
- Use dependency injection for database sessions
- Write one test per behaviour, not per function

## Don't
- Import from circular modules
- Use `global` variables

praisonai code "Add a new user endpoint"

praisonai code --no-context "Explain what Python is"

PRAISON_NO_CONTEXT=true praisonai run task.yaml

{
  "context_token_budget": 4000
}

​

Discovery Rules

​

Precedence

​

What to Put in AGENTS.md

• Tech stack — language versions, key frameworks, database
• Code conventions — naming, formatting, patterns to follow
• Do/Don’t rules — specific things the agent should or should not do
• Key file locations — where models, routes, tests live
• Project-specific vocabulary — domain terms, component names

• Long prose the agent doesn’t need for most tasks
• Secrets or credentials (they will end up in logs)
• Entire source files or large schemas — use --file flags instead

​

Best Practices

env:
  PRAISON_NO_CONTEXT: "true"

​

Related