All agents in this system. Every agent has a defined role, owns specific skills, and follows strict financial and architectural rules.
🤖 Agent Registry
All agents in this system. Every agent has a defined role, owns specific skills, and follows strict financial and architectural rules.
Business Domain Agents
| Agent | File | Owned Skills | Primary Role |
|---|
billing.agent | billing.agent.md | create_invoice · calculate_gst · apply_discount · process_payment | POS billing, invoice lifecycle, payments |
accounting.agent | accounting.agent.md | post_journal · generate_ledger · trial_balance | Double-entry accounting, CoA, period close |
inventory.agent | inventory.agent.md | update_stock · weight_handling · low_stock_alert | Stock management, SKU + weight-based items |
reconciliation.agent | reconciliation.agent.md | match_transactions · settlement_tracking · fee_calculation | Bank reconciliation, gateway settlements |
recovery.agent | recovery.agent.md | detect_overdue · send_reminder · generate_payment_link | Collections, dunning, payment recovery |
reporting.agent | reporting.agent.md | profit_loss · balance_sheet · cash_flow | Financial reports, GST returns, analytics |
Technical Agents
| Agent | File | Scope | Primary Role |
|---|
backend-developer.agent | backend-developer.agent.md | Backend codebase (/backend) | Laravel 12 API, services, repositories, migrations |
frontend-developer.agent | frontend-developer.agent.md | Frontend codebase (/frontend) | React 19 modules, hooks, service layer, POS UI |
uiux-designer.agent | uiux-designer.agent.md | Design system & all UI | Component design, user flows, accessibility, tokens |
Agent Invocation Rules
- Always delegate — business logic routes through the appropriate domain agent.
- Accounting is mandatory — every financial event MUST call
accounting.agent → post_journal. No exceptions.
- Skills are owned — only the owning agent may invoke its skill. No cross-agent skill calls.
- Sequence matters — follow the dependency chain in workflows.md. Do not skip steps.
- Audit always — every agent action that touches financial data emits an audit log entry.
- Technical agents implement —
backend-developer.agent and frontend-developer.agent implement what domain agents define. uiux-designer.agent designs what frontend-developer.agent builds.
Agent Dependency Map
billing.agent
│── calls ──► inventory.agent → update_stock (stock deduction on confirmed sale)
│── calls ──► accounting.agent → post_journal (sales + payment journal entries)
└── reads ──► recovery.agent → detect_overdue (credit sale overdue check)
reconciliation.agent
└── calls ──► accounting.agent → post_journal (settlement + adjustment entries)
recovery.agent
│── calls ──► billing.agent → process_payment (record recovered payment)
└── calls ──► accounting.agent → post_journal (cash receipt on recovery)
reporting.agent
│── calls ──► accounting.agent → trial_balance (pre-report validation)
│── calls ──► accounting.agent → generate_ledger (account data reads)
└── reads ──► all modules (read-only access)
backend-developer.agent
└── implements ──► all domain agent API specs, services, repositories, and DB migrations
frontend-developer.agent
│── implements ──► all domain agent UI requirements and API service layer
└── collaborates ──► uiux-designer.agent (receives design handoff, implements components)
uiux-designer.agent
└── designs for ──► frontend-developer.agent (produces layouts, tokens, component specs)
Mandatory Accounting Triggers
Any agent that causes a financial event MUST call accounting.agent → post_journal:
| Trigger Event | Calling Agent | Journal Entry |
|---|
| Invoice confirmed | billing.agent | DR A/R or Cash · CR Sales Revenue + CGST Payable + SGST Payable |
| Payment received | billing.agent | DR Cash / Bank / Clearing · CR Accounts Receivable |
| Invoice cancelled | billing.agent | Mirror reversal of original entry |
| Gateway settlement | reconciliation.agent | DR Bank + Fee Exp + GST ITC · CR Gateway Clearing |
| Inventory purchase (GRN) | inventory.agent | DR Inventory Asset · CR Accounts Payable or Cash |
| Recovery payment | recovery.agent | DR Cash / Bank · CR Accounts Receivable |
| Month-end accruals | accounting.agent | DR/CR appropriate accrual accounts |
Skill-to-Agent Ownership Map
New Technical Agents