# ============================================================ # AI AGENT TEMPLATE # Enterprise AI Engineering Framework # Version 1.0 # ============================================================ Purpose This document defines the standard specification for every AI Agent inside the Enterprise AI Operating System. Every AI Agent shall follow this specification. No custom format is allowed. ============================================================ 1. AGENT IDENTITY ============================================================ Agent Name Agent Type Version Owner Priority Status ============================================================ 2. MISSION ============================================================ Clearly define the primary mission of this agent. The mission shall never overlap another agent. ============================================================ 3. RESPONSIBILITIES ============================================================ Define everything this agent is responsible for. Responsibilities shall be explicit. Responsibilities shall be measurable. ============================================================ 4. RESPONSIBILITY BOUNDARY ============================================================ Clearly define what this agent shall NOT do. This prevents overlapping authority. ============================================================ 5. AUTHORITY ============================================================ Define which decisions the agent may make independently. Examples Approve Reject Recommend Analyze Review Generate Escalate ============================================================ 6. DECISION LIMITATION ============================================================ The agent shall never make decisions outside its authority. Uncertainty shall be escalated. ============================================================ 7. REQUIRED KNOWLEDGE ============================================================ The agent shall always read required documents before working. Examples AI_PROJECT_CONSTITUTION.md PROJECT_CONTEXT.md ERP_KNOWLEDGE_MAP.md AI_THINKING_MODEL.md Relevant Shared Knowledge ============================================================ 8. INPUT ============================================================ Examples Task Repository Files Database Schema Business Flow Bug Report Feature Request ============================================================ 9. OUTPUT ============================================================ Every output shall follow a predictable format. Examples Analysis Recommendation Implementation Plan Review Report Risk Report Architecture Report ============================================================ 10. STANDARD WORKFLOW ============================================================ Receive Task ↓ Understand Context ↓ Load Knowledge ↓ Analyze ↓ Generate Recommendation ↓ Self Review ↓ Deliver Output ============================================================ 11. COMMUNICATION PROTOCOL ============================================================ Every communication shall include Facts Assumptions Risks Recommendations Confidence Level ============================================================ 12. ESCALATION RULES ============================================================ Escalate when Business Rule Conflict Accounting Conflict Tax Conflict Architecture Conflict Security Conflict Missing Information ============================================================ 13. REVIEW CHECKLIST ============================================================ Business Accounting Tax Architecture Database Security Performance Documentation Technical Debt ============================================================ 14. DEFINITION OF SUCCESS ============================================================ The agent has successfully completed its task when Output is correct. Output is consistent. Output is reviewable. Output is reproducible. Output follows Constitution. ============================================================ 15. ANTI PATTERNS ============================================================ The agent shall never Guess business rules. Invent accounting rules. Ignore taxation. Ignore architecture. Ignore technical debt. Ignore backward compatibility. ============================================================ 16. QUALITY SCORE ============================================================ Each agent shall evaluate itself. Business Architecture Database Accounting Tax Security Performance Maintainability Documentation Overall Confidence ============================================================ END OF TEMPLATE ============================================================ # ============================================================ # ARCHITECTURE DECISION RECORD # ============================================================ Purpose Record every important architecture decision. ============================================================ FORMAT ============================================================ ADR ID Date Decision Problem Alternatives Reason Impact Risk Approved By Status ============================================================ RULE ============================================================ Every architecture decision shall have one ADR. Never overwrite previous decisions. ============================================================ END OF DOCUMENT ============================================================ # ============================================================ # LESSON LEARNED # ============================================================ Purpose Store knowledge from completed work. ============================================================ FORMAT ============================================================ Date Issue Root Cause Solution Recommendation Affected Module Owner ============================================================ RULE ============================================================ Every production issue shall become a lesson learned. Repeated issues shall be escalated. ============================================================ END OF DOCUMENT ============================================================ # ============================================================ # KNOWN ISSUE # ============================================================ Purpose Maintain known application limitations. ============================================================ FORMAT ============================================================ Issue ID Module Description Impact Temporary Solution Permanent Solution Status ============================================================ STATUS ============================================================ Open Investigating Resolved Closed ============================================================ END OF DOCUMENT ============================================================ # ============================================================ # CODE REVIEW HISTORY # ============================================================ Purpose Store every code review result. ============================================================ FORMAT ============================================================ Review ID Date Reviewer Module Score Critical High Medium Low Recommendation Status ============================================================ RULE ============================================================ Review history shall never be deleted. ============================================================ END OF DOCUMENT ============================================================ # ============================================================ # EXECUTIVE SUMMARY TEMPLATE # ============================================================ Project Review Date Reviewer Scope ============================================================ Overall Score Enterprise Grade Business Risk Technical Risk Accounting Risk Tax Risk Security Risk Performance Risk ============================================================ Top Findings Critical High Medium Low ============================================================ Recommendation Immediate Action Short Term Mid Term Long Term ============================================================ Estimated Effort Estimated Sprint Estimated Cost ============================================================ Approval Reviewer Architect Moderator ============================================================ END # ============================================================ # CODE REVIEW REPORT # ============================================================ Repository Branch Commit Module Reviewer ============================================================ Controller Score Model Score Library Score Helper Score View Score ============================================================ Complexity Maintainability Readability Duplication Architecture ============================================================ Violation Critical High Medium Low ============================================================ Recommendation ============================================================ Technical Debt ============================================================ END # ============================================================ # DATABASE REVIEW REPORT # ============================================================ Schema Database Version Reviewer ============================================================ Normalization Relationship Constraint Index Performance ============================================================ Table Review Index Review SQL Review Migration Review ============================================================ Risk Recommendation ============================================================ END # ============================================================ # BUSINESS AUDIT REPORT # ============================================================ Business Area Module Reviewer ============================================================ Workflow Approval Validation Exception Reporting ============================================================ Business Risk Recommendation Priority ============================================================ END # ============================================================ # ACCOUNTING AUDIT REPORT # ============================================================ Module Reviewer ============================================================ Journal Ledger Posting Trial Balance Closing Opening COGS Inventory ============================================================ Accounting Score Risk Recommendation ============================================================ END # ============================================================ # TAX AUDIT REPORT # ============================================================ Module Reviewer ============================================================ PPN PPH e-Faktur e-Bupot Tax Posting Tax Report ============================================================ Compliance Risk Recommendation ============================================================ END # ============================================================ # SECURITY AUDIT REPORT # ============================================================ Authentication Authorization Session Configuration Sensitive Data SQL Injection CSRF XSS ============================================================ Security Score Recommendation ============================================================ END # ============================================================ # PERFORMANCE REPORT # ============================================================ Database Memory Session Import Export Query Cache ============================================================ Performance Score Optimization Estimated Improvement ============================================================ END # ============================================================ # ERP MODERNIZATION ROADMAP # ============================================================ Current State Target State Priority Dependencies Sprint Owner Risk Benefit ============================================================ Phase 1 Phase 2 Phase 3 ... ============================================================ Target Score ============================================================ END # ============================================================ # ENTERPRISE HEALTH REPORT # ============================================================ Application Version Review Date ============================================================ Business __/100 Architecture __/100 Database __/100 Accounting __/100 Tax __/100 Security __/100 Performance __/100 Coding __/100 Documentation __/100 Testing __/100 ============================================================ Overall Score __/100 ============================================================ Enterprise Grade A+ A B+ B C D ============================================================ Technical Debt Critical High Medium Low ============================================================ Business Risk Accounting Risk Tax Risk Security Risk Performance Risk ============================================================ Estimated Refactoring Estimated Sprint Estimated Budget ============================================================ Roadmap Immediate 30 Days 90 Days 180 Days 1 Year ============================================================ Conclusion ============================================================ END