Documenting Your Risk Framework
Documenting Your Risk Framework
The difference between a plan and a practice is documentation. A trader can think they have risk management discipline, but until they write it down, they don't. Writing forces clarity. It reveals gaps in your thinking. It creates a document you can refer to when emotion runs high. And it allows your framework to evolve systematically rather than haphazardly.
The best traders carry a document—sometimes called a rulebook, trading manual, or investment policy statement—that specifies every rule, exception, and procedure. According to research from Financial Analysts Journal, traders who maintain a written investment policy statement outperform those without one by 2-4% annually, primarily through better discipline and fewer emotional decisions. The document is insurance against reverting to old habits during stress.
Quick definition: Framework documentation is a written rulebook specifying your position-sizing rules, stop-loss framework, review processes, rebalancing schedule, and entry/exit criteria. It's a reference document you consult before major decisions and update quarterly.
Key takeaways
- Write your framework as a living document, not set-in-stone rules (you'll update it quarterly)
- Use a hierarchical structure: Investment policy statement (top level) → specific rules (middle level) → procedures (detailed level)
- Include a version history so you can see what changed and why
- Build flexibility: allow exceptions, but document them so they don't become habits
- Use your document before trading, not after—it's a guide, not a post-mortem
The Five Sections of a Risk Framework Document
A complete framework document has five levels, from philosophy to procedures.
Section 1: Investment Objectives and Philosophy
Start with why you're doing this. Your philosophy statement is 3-5 sentences capturing your approach.
Example: "I'm a long-term investor with a 15-year time horizon. My goal is to achieve 8% annual returns with minimal volatility. I believe disciplined risk management and rebalancing outperform market timing and speculation. I will prioritize capital preservation over maximum returns. I will never risk more than 2% of my account on a single position and will never allow any position to exceed 5% of portfolio equity."
This is personal. It informs every decision downstream. When you're tempted to go all-in on a "sure thing," you reread this section and remember your philosophy.
Section 2: Target Allocation and Rebalancing
Specify your target asset allocation with tolerance bands.
Example:
TARGET ALLOCATION (US Markets, <$500,000 account):
- U.S. Stocks: 55% (bands: 50-65%)
- International Stocks: 15% (bands: 10-20%)
- Bonds: 20% (bands: 15-25%)
- Alternatives (Real Estate, Commodities): 5% (bands: 2-8%)
- Cash: 5% (bands: 3-10%)
REBALANCING RULES:
- Calendar: Quarterly (first Friday of each quarter)
- Threshold: Rebalance immediately if any asset class drifts more than 10% from target
- Tax: In taxable accounts, harvest losses before taking gains
- New money: Deploy to underweight asset classes before rebalancing
Specificity matters. "60% stocks" is vague. "60% U.S. stocks, 15% international stocks, 20% bonds, 5% cash, rebalance quarterly if drifts beyond 5% band" is actionable.
Section 3: Position Sizing and Risk Rules
Detail your position-sizing discipline.
Example:
POSITION SIZING FRAMEWORK:
General Rules:
- Maximum position size: 5% of portfolio equity
- Maximum risk per position: 1% of account
- Maximum portfolio heat (sum of all position risks): 5% of account
- No position enters unless it passes the pre-trade risk checklist
For Different Position Types:
- Core holdings (5+ year thesis): Up to 5% of portfolio
- Swing trades (4-12 weeks): Up to 3% of portfolio
- Short-term trades (days to 4 weeks): Up to 1% of portfolio
- Speculative trades (options, crypto): Up to 0.5% of portfolio
Position Sizing Formula:
Risk per position = (Account equity × 1%) / (Entry price - Stop price)
Position size = Risk per position / (Entry price - Stop price) × Entry price
STOPS:
- Every position has a stop-loss, non-negotiable
- Stops can be percentage-based (10-15% for stocks), technical (support, MA), or dollar-based (<$500)
- Hard stops: Never exceeded. Execute automatically.
- Soft stops: Review trigger. May hold if thesis is valid.
- Stops are NOT to be widened after entry, only tightened
- Stop placement is verified on pre-trade checklist
These rules remove the "how much should I buy?" guessing game.
Section 4: Review and Monitoring Procedures
Specify when and how you review.
Example:
POSITION REVIEW SCHEDULE:
Daily (1 minute per position):
- Check no critical news has broken
- Verify stop-loss orders are still in place
- Note any approaching earnings or events
Weekly (30 minutes total):
- Technical review of each position
- Check stop-loss levels are still appropriate
- Verify no positions are approaching stops without plan
Monthly (1 hour):
- Full thesis review of each position
- Reread original entry thesis; compare to current price and thesis
- Update position journal with any changes
- Conduct post-trade reviews for all closed positions
Quarterly (2-3 hours):
- Full portfolio review and rebalancing
- Check allocation against targets
- Review performance of each position and setup type
- Identify patterns in wins and losses
- Update framework rules if needed
Event-Triggered Reviews:
- Immediately after any position breaks down 10%
- Immediately after company-specific news
- Before and immediately after earnings reports
- On dividend/interest payment dates
Specificity prevents skipping. "I review my positions" is vague. "Every Friday at 2 PM, I spend 30 minutes reviewing technical levels" is a real commitment.
Section 5: Procedures and Checklists
Provide step-by-step procedures for common decisions.
Example: Pre-Trade Entry Procedure:
BEFORE EVERY ENTRY:
1. Write thesis in one sentence; if you can't, don't enter
2. Identify entry price and exit stop price (not percentage, exact price)
3. Calculate risk: (Entry - Stop) × Shares = Dollar risk
4. Verify risk is <1% of account; if not, reduce position size
5. Calculate profit target: what is potential upside?
6. Calculate risk-reward ratio: must be at least 1:2 (risk <$500 for potential <$1,000 gain)
7. Check portfolio heat: existing positions' total risk + new risk must be <5% account
8. Verify: Are any earnings or events within 5 trading days? (If yes, plan for volatility)
9. Check pre-trade checklist (all boxes Yes)
10. Place order with stop-loss order at same time
11. Record in trading journal: entry price, stop, position size, thesis
When you're tempted to "just buy a quick position," this procedure slows you down and catches mistakes.
Example: Exit Procedure:
WHEN EXITING A POSITION:
1. Log exit date, price, reason (thesis break, stop hit, profit target, time limit)
2. Calculate P&L and percentage return
3. Record in journal
4. Do NOT trade another position for 30 minutes (avoid revenge trading)
5. Within 24 hours: Complete post-trade review using template
6. File review in trading journal
This prevents the "exit and immediately re-enter" trap that emotional traders fall into.
Creating Your Documentation Workflow
Don't try to write the perfect framework on day one. Iterate.
Month 1: Write a draft framework. Include your philosophy, target allocation, basic position-sizing rules, and a pre-entry checklist. It will be incomplete. That's fine.
Month 2-3: Trade using your draft framework. Note places where it's unclear or where you make exceptions.
Month 4: Revise based on what you learned. Tighten rules that were too loose. Clarify rules that caused confusion.
Quarterly thereafter: Update your framework quarterly. Review what worked and what didn't in the past 3 months. Make one or two intentional changes. Document the change with a date and reason.
Over time, your framework becomes a living document reflecting real trading experience, not theoretical ideas.
Version Control and Change Log
Treat your framework like software: version it and track changes.
Example:
FRAMEWORK VERSION HISTORY:
Version 1.0 (January 2024) — Initial framework
Version 1.1 (April 2024) — Added event-triggered review rules; expanded position sizing for options
Version 1.2 (July 2024) — Tightened stops on swing trades from 12% to 8%; changed rebalancing from quarterly to 5% threshold
Version 2.0 (January 2025) — Major revision: added profit target rules and soft-stop framework
Version 2.1 (April 2025) — Added specific procedures for pre-earnings exits; expanded FAQ
Changes in Version 2.1 (April 2025):
- ADDED: Pre-earnings exit procedure (exit 2 days before earnings on all speculative positions)
- REVISED: Soft-stop review criteria (now requires thesis validation + technical confirmation)
- REMOVED: Daily position-review requirement (was taking too much time; replaced with weekly reviews)
- REASON: Realized earnings volatility was killing profitable setups; pre-earnings exits reduced drawdown 15%
This history proves your framework is based on experience, not guesswork.
Documentation structure
What Your Framework Should NOT Include
Be careful not to over-document. Some things shouldn't be in your framework.
Don't include:
- Specific stock picks or sector preferences (these change too often and belong in a research notebook, not your framework)
- Market timing rules ("buy when VIX < 15, sell when VIX > 25")—these rarely work and evolve constantly
- Complex formulas or probability calculations—if it's too complex to execute in 30 seconds, it's not practical
- Aspirational goals ("I will be profitable every month")—focus on behaviors (following checklists), not outcomes
Do include:
- Non-negotiable discipline rules (stops, position sizing, checklists)
- Review schedules and procedures
- Decision frameworks (when to hold vs. exit, when to rebalance)
- Flexibility guidelines (when exceptions are allowed)
Real-World Framework Example: A Complete Section
Here's how a trader documents a specific rule comprehensively:
RULE: Position Size Allocation Across Account Equity
PHILOSOPHY:
I size positions as percentages of account equity, not fixed dollar amounts, because this scales risk as my account grows. All positions should contribute equally to portfolio risk.
RULE:
Every position risks 0.75% to 1.5% of account equity, depending on confidence:
- High-conviction setups (90%+ thesis confidence): 1-1.5% risk
- Medium-conviction setups (70-89% confidence): 0.75-1% risk
- Low-conviction setups (50-69% confidence): Do not enter; too much uncertainty
FORMULA:
Position size = (Account equity × Risk %) / (Entry price - Stop price)
EXAMPLE:
Account: $100,000
Setup: High conviction (1.5% risk target)
Entry: $50, Stop: $45 (Risk <$5 per share)
Calculation: ($100,000 × 0.015) / $5 = 300 shares
Position: 300 shares × $50 = $15,000 (15% of account, risking $1,500)
WHEN THIS RULE APPLIES:
All equity positions (stocks, ETFs), both long and short.
EXCEPTIONS:
- Core holdings (10+ year horizon): Can be up to 5% of account with stop at 20% loss
- Options: Dollar-based stop (<$500 loss max) overrides percentage rule
- Cash drains from emergency: Can reduce position sizes temporarily
HOW TO VERIFY:
Pre-trade checklist: "Will this position, if stopped out, risk less than 1.5% of account?" Yes/No.
WHEN THIS RULE CHANGED:
Version 1.0 (Jan 2024): Fixed <$1,000 risk per position
Version 1.1 (Apr 2024): Changed to percentage-based to scale with account growth
Version 2.0 (Jan 2025): Added confidence-based tiers (high/medium/low conviction)
WHY IT CHANGED:
Jan 2024: <$1,000 didn't scale as account grew from <$50K to <$150K. One "big trade" was <1% risk at <$50K but 0.3% risk at <$150K.
Jan 2025: Added confidence tiers after noticing low-conviction trades lost more often; wanted to size down on uncertain setups.
This level of documentation prevents future confusion. Anyone reading this (including future you) understands not just the rule but why it exists.
FAQ
How long should my framework document be?
Depends on complexity, but 15-30 pages is typical. Long enough to be thorough, short enough that you'll actually read it. If it's 100 pages, you won't use it.
Should I share my framework with other traders?
Yes, eventually. Discuss the philosophy and rules with other traders. Their feedback helps you see blind spots. But your framework should be personal—what works for them might not work for you.
How often should I update my framework?
Quarterly minimum. After 20-30 trades, you'll see patterns worth documenting. Update to add rules that prevent recurring problems. But don't change rules constantly—give each rule at least 3 months of trading data before revising.
Should my framework include specific entry signals (moving averages, chart patterns)?
Generally no. Entry signals change based on market conditions. Put those in a separate "Market Conditions & Setups" document that evolves frequently. Your core framework should be stable and focus on risk management.
What if I find my documented rules don't work in practice?
That's the point of documentation—it reveals what doesn't work. Change the rules, document why, and test the new version. The worst outcome is discovering a rule doesn't work after years of trading. Documentation catches this in weeks.
Should I print my framework and carry it?
Some traders do. Others keep it on their phone. Some share it with a coach or mentor who can review if they're following it. The medium matters less than accessibility—you should be able to reference it during trading hours.
Can my framework change if market conditions change?
Yes, but document it. "In 2024, the Fed was tightening; I used 8% stops. In 2025, the Fed is cutting; I switched to 12% stops." Document the change and reason. Don't let your framework drift without knowing it.
Should my framework include specific loss limits (max drawdown, daily loss limits)?
Absolutely. Most frameworks include "Max drawdown: 15% of account from peak. If exceeded, stop trading for 2 weeks." Daily loss limits can be useful ("If I lose <2% of account in a day, I stop trading") but are less important than overall position-sizing discipline.
Related concepts
Summary
Documentation transforms a vague plan into actionable discipline. Your framework document should include your investment philosophy, target allocation and rebalancing rules, position-sizing discipline, review and monitoring procedures, and detailed procedures for common decisions. Use a version history to track how your framework evolves based on trading experience. Treat the document as a living artifact that you update quarterly, not a static rulebook. The act of writing forces clarity; the document itself prevents backsliding; the version history proves your framework is based on evidence, not guesswork.