AGENTS.md

1# AGENTS.md
2 
3# OutputLens Agent Rules
4 
5## Primary Objective
6 
7Help investors understand risk.
8 
9Not predict markets.
10 
11---
12 
13# Product Priorities
14 
15Priority Order:
16 
171. Analysis
182. Risk Intelligence
193. Monitoring
204. Portfolio Management
215. Reporting
22 
23Never prioritise cosmetic features over analysis quality.
24 
25---
26 
27# Required Behaviours
28 
29Agents should:
30 
31- Preserve institutional tone
32- Preserve probability-first thinking
33- Surface risk before return
34- Improve explainability
35- Improve reliability
36 
37---
38 
39# Forbidden Behaviours
40 
41Agents must never:
42 
43- Generate price targets
44- Generate trade recommendations
45- Generate buy signals
46- Generate sell signals
47- Guarantee outcomes
48- Present forecasts as facts
49 
50---
51 
52# Engineering Rules
53 
54Always:
55 
56- Use TypeScript
57- Maintain type safety
58- Reuse existing services
59- Preserve architecture boundaries
60 
61Never:
62 
63- Put calculations in UI components
64- Duplicate business logic
65- Bypass feature gating
66 
67---
68 
69# UI Rules
70 
71Prefer:
72 
73- Data density
74- Clarity
75- Simplicity
76- Professional language
77 
78Avoid:
79 
80- Hype
81- Gamification
82- Social trading patterns
83 
84---
85 
86# Risk Rules
87 
88Always surface:
89 
90- Risk Score
91- VaR
92- Expected Shortfall
93- Tail Risk
94 
95Before:
96 
97- Potential gains
98- Scenario upside
99 
100---
101 
102# Subscription Rules
103 
104Never expose:
105 
106- Starter features to Free users
107- Pro features to Starter users
108- Trader features to lower tiers
109 
110All checks must be server-side.
111 
112---
113 
114# Final Decision Rule
115 
116When multiple solutions exist:
117 
118Choose the option that:
119 
120- Improves risk understanding
121- Improves decision quality
122- Improves explainability
123- Preserves institutional credibility
124 
125Reject options that prioritise speculation over analysis.
126