feat: add use-agent-economy skill

[OliverDevDS]

What this PR adds

A new skill use-agent-economy covering the full lifecycle of an autonomous agent as an economic subject on Arc.

Motivation

Existing skills cover each Circle primitive in isolation. This skill shows how ERC-8004 + ERC-8183 + Circle Gateway + Modular Wallets compose into a cohesive pattern for agents that earn, hold, and manage their own USDC without a human approving every transaction.

What's included

• SKILL.md with 4 layers: Identity → Commerce → Reputation → Treasury
• Dynamic reputation scoring (not hardcoded)
• Guardian threshold pattern for autonomous + overseen spending
• 5 antipatterns documented
• Decision guide mapping agent needs to Circle primitives

Closes #8

---

Submitted via Claude Code + WSL using the Circle MCP server.

[OliverDevDS]

Proof of concept — Arc Testnet

The use-agent-economy skill was validated end-to-end on Arc Testnet. All 4 transactions confirmed, all 13 verification checks passed.

Agent

Field	Value
Address	0xb4a679303e8d72b79c388508042b61feba2dd2e6
Agent ID	1625 (ERC-8004 IdentityRegistry)
Job ID	1152 (ERC-8183 AgenticCommerce)
Reputation score	92/100

Transactions

Step	Tx	Block
Register identity (ERC-8004)	0xb693...e1b	36144399
Create job (ERC-8183)	0xddb5...aab	36144409
Submit deliverable	0xaed8...3f0	36200680
Record reputation	0xdb69...a4d	36200689

Verification results

✓ Identity registration tx confirmed     →  block 36144399
✓ Job creation tx confirmed              →  block 36144409
✓ Deliverable submission tx confirmed    →  block 36200680
✓ Reputation recording tx confirmed      →  block 36200689
✓ Agent ID 1625 owned by agent wallet    →  0xb4A679303e8D72b79C388508042b61FeBa2dD2E6
✓ Metadata URI present
✓ Job ID 1152 exists                     →  status: Submitted
✓ Provider is the agent wallet           →  0xb4A679303e8D72b79C388508042b61FeBa2dD2E6
✓ Evaluator is correct                   →  0x19868832E52E6bF64aed577de060782a63210897
✓ Job status is Submitted
✓ Reputation recorded onchain            →  1 log for agent ID 1625

Result: 13/13 passed

What was tested

The full use-agent-economy lifecycle was executed using the Circle Developer Controlled Wallets SDK on Arc Testnet:

1. Identity — agent registered via ERC-8004 IdentityRegistry.register() with capability metadata encoded as base64 JSON
2. Commerce — job created via ERC-8183 AgenticCommerce.createJob() with the agent as provider
3. Deliverable — output hash committed onchain via submit()
4. Reputation — score 92/100 recorded by an independent evaluator wallet via ReputationRegistry.giveFeedback()

All transactions were submitted via Claude Code + WSL using the Circle MCP server.

---

Explorer: https://testnet.arcscan.app/address/0xb4a679303e8d72b79c388508042b61feba2dd2e6

[OliverDevDS]

Additional validation — complete() and reject() flows

Validated the full job lifecycle including completion and dispute flows on Arc Testnet.

Job 1161 — complete() flow

Step	Tx
createJob	0xa6cc...671
setBudget	0xe431...79b
fund escrow	0xbf0b...6c6
submit	0xa63f...b6
complete	0x3c8d...0e

Result: status Completed — agent received 1 USDC

Job 1162 — reject() flow

Step	Tx
createJob	0x7e14...38b
fund escrow	0x2e62...71
submit	0xe12f...0e
reject	0x7893...cc

Result: status Rejected — escrow refunded to client

Balance verification

Wallet	Before	After complete	After reject
Agent	0 USDC	1 USDC	1 USDC
Evaluator	20 USDC	19 USDC	19 USDC

Reject correctly returns escrow to the client — the agent receives nothing when work is rejected.