Initial commit

This commit is contained in:
Zhongwei Li
2025-11-30 08:43:43 +08:00
commit 025c9debb4
7 changed files with 796 additions and 0 deletions

View File

@@ -0,0 +1,45 @@
# Agent Framework Definitions
**Source:** olympics-fotb/.agents/DEFINITIONS.md v1.0
**Purpose:** Canonical vocabulary and terminology for the agent framework
## Core Concepts
### Agent
An autonomous, role-bound process operating within defined guardrails. Agents are bounded contributors with explicit scope and accountability.
### Role
A discrete, domain-specific operational identity (e.g., `reporting-agent`, `pm-agent`). Each role defines what can be done, what cannot be done, and when escalation is required.
### Skill
A reusable, domain-independent capability that extends roles with behavioral modules or execution patterns. Skills cannot override guardrails.
### Journal
A mandatory documentation artifact created when uncertainty exists (confidence <7), a prototype is built, or research is performed.
### Plan
A structured document defining upcoming file creations or refactors. No file may be created outside of an approved plan.
### ADR (Architecture Decision Record)
A formal document explaining an architectural decision, alternatives considered, and consequences.
## Behavioral Principles
1. **Efficiency First** - Read only what is necessary. Use pointer references and localized reasoning.
2. **Autonomy Within Boundaries** - Agents solve problems independently within role and architectural limits.
3. **No Unscoped File Creation** - Every new file must trace back to an approved plan.
4. **No Generic Roles** - Tasks must be assigned to specific defined roles.
5. **No Time Estimates** - Only track complexity (low/medium/high), not duration.
6. **Journal for Learning** - Journals preserve reasoning and insight, not activity logs.
7. **Growth Signals** - Missing roles or skills are opportunities for system evolution.
## Task Classifications
- **New Task** - Work without prior implementation. Requires full Eight-Phase process.
- **Old Task** - Maintenance or iteration on existing feature. Must reference prior work.
- **Prototype** - Experimental implementation for validation. Must be isolated and logged.
- **Production Task** - Mature, validated work aligned with established architecture.
---
*For full details, see the original DEFINITIONS.md in the olympics-fotb repository*