documentação do sistema

.context/agents/README.md

@@ -0,0 +1,27 @@
+# Agent Handbook
+
+This directory contains ready-to-customize playbooks for AI agents collaborating on the repository.
+
+## Available Agents
+- [Code Reviewer](./code-reviewer.md) — Review code changes for quality, style, and best practices
+- [Bug Fixer](./bug-fixer.md) — Analyze bug reports and error messages
+- [Feature Developer](./feature-developer.md) — Implement new features according to specifications
+- [Refactoring Specialist](./refactoring-specialist.md) — Identify code smells and improvement opportunities
+- [Test Writer](./test-writer.md) — Write comprehensive unit and integration tests
+- [Documentation Writer](./documentation-writer.md) — Create clear, comprehensive documentation
+- [Performance Optimizer](./performance-optimizer.md) — Identify performance bottlenecks
+- [Security Auditor](./security-auditor.md) — Identify security vulnerabilities
+- [Frontend Specialist](./frontend-specialist.md) — Design and implement user interfaces
+- [Architect Specialist](./architect-specialist.md) — Design overall system architecture and patterns
+- [Devops Specialist](./devops-specialist.md) — Design and maintain CI/CD pipelines
+
+## How To Use These Playbooks
+1. Pick the agent that matches your task.
+2. Enrich the template with project-specific context or links.
+3. Share the final prompt with your AI assistant.
+4. Capture learnings in the relevant documentation file so future runs improve.
+
+## Related Resources
+- [Documentation Index](../docs/README.md)
+- [Agent Knowledge Base](../../AGENTS.md)
+- [Contributor Guidelines](../../CONTRIBUTING.md)

.context/agents/architect-specialist.md

@@ -0,0 +1,10 @@
+---
+type: agent
+name: Architect Specialist
+description: Design overall system architecture and patterns
+agentType: architect-specialist
+phases: [P, R]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/agents/bug-fixer.md

@@ -0,0 +1,10 @@
+---
+type: agent
+name: Bug Fixer
+description: Analyze bug reports and error messages
+agentType: bug-fixer
+phases: [E, V]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/agents/code-reviewer.md

@@ -0,0 +1,10 @@
+---
+type: agent
+name: Code Reviewer
+description: Review code changes for quality, style, and best practices
+agentType: code-reviewer
+phases: [R, V]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/agents/devops-specialist.md

@@ -0,0 +1,10 @@
+---
+type: agent
+name: Devops Specialist
+description: Design and maintain CI/CD pipelines
+agentType: devops-specialist
+phases: [E, C]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/agents/documentation-writer.md

@@ -0,0 +1,10 @@
+---
+type: agent
+name: Documentation Writer
+description: Create clear, comprehensive documentation
+agentType: documentation-writer
+phases: [P, C]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/agents/feature-developer.md

@@ -0,0 +1,10 @@
+---
+type: agent
+name: Feature Developer
+description: Implement new features according to specifications
+agentType: feature-developer
+phases: [P, E]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/agents/frontend-specialist.md

@@ -0,0 +1,10 @@
+---
+type: agent
+name: Frontend Specialist
+description: Design and implement user interfaces
+agentType: frontend-specialist
+phases: [P, E]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/agents/performance-optimizer.md

@@ -0,0 +1,10 @@
+---
+type: agent
+name: Performance Optimizer
+description: Identify performance bottlenecks
+agentType: performance-optimizer
+phases: [E, V]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/agents/refactoring-specialist.md

@@ -0,0 +1,10 @@
+---
+type: agent
+name: Refactoring Specialist
+description: Identify code smells and improvement opportunities
+agentType: refactoring-specialist
+phases: [E]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/agents/security-auditor.md

@@ -0,0 +1,10 @@
+---
+type: agent
+name: Security Auditor
+description: Identify security vulnerabilities
+agentType: security-auditor
+phases: [R, V]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---

.context/agents/test-writer.md

@@ -0,0 +1,10 @@
+---
+type: agent
+name: Test Writer
+description: Write comprehensive unit and integration tests
+agentType: test-writer
+phases: [E, V]
+generated: 2026-04-29
+status: unfilled
+scaffoldVersion: "2.0.0"
+---