superkit-mcp-server 1.2.4 → 1.2.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (161) hide show
  1. package/ARCHITECTURE.md +102 -102
  2. package/README.md +71 -71
  3. package/SUPERKIT.md +168 -168
  4. package/agents/code-archaeologist.md +106 -106
  5. package/agents/coder.md +90 -90
  6. package/agents/data-engineer.md +28 -28
  7. package/agents/devops-engineer.md +242 -242
  8. package/agents/git-manager.md +203 -203
  9. package/agents/orchestrator.md +420 -420
  10. package/agents/penetration-tester.md +188 -188
  11. package/agents/performance-optimizer.md +187 -187
  12. package/agents/planner.md +270 -270
  13. package/agents/qa-automation-engineer.md +103 -103
  14. package/agents/quant-developer.md +32 -32
  15. package/agents/reviewer.md +100 -100
  16. package/agents/scout.md +222 -222
  17. package/agents/tester.md +274 -274
  18. package/agents/ui-designer.md +208 -208
  19. package/build/index.js +88 -45
  20. package/build/tools/todoTools.js +39 -39
  21. package/build/tools/validators/__tests__/apiSchema.test.js +23 -23
  22. package/build/tools/validators/__tests__/convertRules.test.js +5 -5
  23. package/build/tools/validators/__tests__/frontendDesign.test.js +12 -12
  24. package/build/tools/validators/__tests__/geoChecker.test.js +19 -19
  25. package/build/tools/validators/__tests__/mobileAudit.test.js +12 -12
  26. package/build/tools/validators/__tests__/reactPerformanceChecker.test.js +17 -17
  27. package/build/tools/validators/__tests__/securityScan.test.js +6 -6
  28. package/build/tools/validators/__tests__/seoChecker.test.js +16 -16
  29. package/build/tools/validators/__tests__/typeCoverage.test.js +14 -14
  30. package/commands/README.md +122 -122
  31. package/commands/ask.toml +72 -72
  32. package/commands/brainstorm.toml +119 -119
  33. package/commands/chat.toml +77 -77
  34. package/commands/code-preview.toml +37 -37
  35. package/commands/code.toml +28 -28
  36. package/commands/content.toml +200 -200
  37. package/commands/cook.toml +77 -77
  38. package/commands/copywrite.toml +131 -131
  39. package/commands/db.toml +192 -192
  40. package/commands/debug.toml +166 -166
  41. package/commands/design.toml +158 -158
  42. package/commands/dev-rules.toml +14 -14
  43. package/commands/do.toml +117 -117
  44. package/commands/doc-rules.toml +14 -14
  45. package/commands/docs.toml +148 -148
  46. package/commands/fix.toml +440 -440
  47. package/commands/fullstack.toml +175 -175
  48. package/commands/git.toml +235 -235
  49. package/commands/help.toml +84 -84
  50. package/commands/integrate.toml +127 -127
  51. package/commands/journal.toml +136 -136
  52. package/commands/kit-setup.toml +40 -40
  53. package/commands/mcp.toml +183 -183
  54. package/commands/orchestration.toml +15 -15
  55. package/commands/plan.toml +206 -172
  56. package/commands/pm.toml +148 -148
  57. package/commands/pr.toml +50 -50
  58. package/commands/project.toml +32 -32
  59. package/commands/research.toml +117 -117
  60. package/commands/review-pr.toml +63 -63
  61. package/commands/review.toml +190 -190
  62. package/commands/scout-ext.toml +97 -97
  63. package/commands/scout.toml +79 -79
  64. package/commands/screenshot.toml +65 -65
  65. package/commands/session.toml +102 -102
  66. package/commands/skill.toml +384 -384
  67. package/commands/status.toml +22 -22
  68. package/commands/team.toml +56 -56
  69. package/commands/test.toml +164 -164
  70. package/commands/ticket.toml +70 -70
  71. package/commands/use.toml +106 -106
  72. package/commands/video.toml +83 -83
  73. package/commands/watzup.toml +71 -71
  74. package/commands/workflow.toml +14 -14
  75. package/package.json +35 -35
  76. package/skills/meta/README.md +30 -30
  77. package/skills/meta/api-design/SKILL.md +134 -134
  78. package/skills/meta/code-review/SKILL.md +44 -44
  79. package/skills/meta/code-review/checklists/pre-merge.md +25 -25
  80. package/skills/meta/code-review/workflows/architecture-pass.md +26 -26
  81. package/skills/meta/code-review/workflows/performance-pass.md +27 -27
  82. package/skills/meta/code-review/workflows/security-pass.md +29 -29
  83. package/skills/meta/compound-docs/SKILL.md +133 -133
  84. package/skills/meta/debug/SKILL.md +40 -40
  85. package/skills/meta/debug/templates/bug-report.template.md +31 -31
  86. package/skills/meta/debug/workflows/reproduce-issue.md +20 -20
  87. package/skills/meta/docker/SKILL.md +126 -126
  88. package/skills/meta/examples/supabase/SKILL.md +46 -46
  89. package/skills/meta/examples/supabase/references/best-practices.md +319 -319
  90. package/skills/meta/examples/supabase/references/common-patterns.md +373 -373
  91. package/skills/meta/examples/supabase/templates/migration-template.sql +49 -49
  92. package/skills/meta/examples/supabase/templates/rls-policy-template.sql +77 -77
  93. package/skills/meta/examples/supabase/workflows/debugging.md +260 -260
  94. package/skills/meta/examples/supabase/workflows/migration-workflow.md +211 -211
  95. package/skills/meta/examples/supabase/workflows/rls-policies.md +244 -244
  96. package/skills/meta/examples/supabase/workflows/schema-design.md +321 -321
  97. package/skills/meta/file-todos/SKILL.md +88 -88
  98. package/skills/meta/mobile/SKILL.md +140 -140
  99. package/skills/meta/nextjs/SKILL.md +101 -101
  100. package/skills/meta/performance/SKILL.md +130 -130
  101. package/skills/meta/react-patterns/SKILL.md +83 -83
  102. package/skills/meta/security/SKILL.md +114 -114
  103. package/skills/meta/session-resume/SKILL.md +96 -96
  104. package/skills/meta/tailwind/SKILL.md +139 -139
  105. package/skills/meta/testing/SKILL.md +43 -43
  106. package/skills/meta/testing/references/vitest-patterns.md +45 -45
  107. package/skills/meta/testing/templates/component-test.template.tsx +37 -37
  108. package/skills/tech/alpha-vantage/SKILL.md +142 -142
  109. package/skills/tech/alpha-vantage/references/commodities.md +153 -153
  110. package/skills/tech/alpha-vantage/references/economic-indicators.md +158 -158
  111. package/skills/tech/alpha-vantage/references/forex-crypto.md +154 -154
  112. package/skills/tech/alpha-vantage/references/fundamentals.md +223 -223
  113. package/skills/tech/alpha-vantage/references/intelligence.md +138 -138
  114. package/skills/tech/alpha-vantage/references/options.md +93 -93
  115. package/skills/tech/alpha-vantage/references/technical-indicators.md +374 -374
  116. package/skills/tech/alpha-vantage/references/time-series.md +157 -157
  117. package/skills/tech/financial-modeling/SKILL.md +18 -18
  118. package/skills/tech/financial-modeling/skills/3-statements/SKILL.md +368 -368
  119. package/skills/tech/financial-modeling/skills/3-statements/references/formatting.md +118 -118
  120. package/skills/tech/financial-modeling/skills/3-statements/references/formulas.md +292 -292
  121. package/skills/tech/financial-modeling/skills/3-statements/references/sec-filings.md +125 -125
  122. package/skills/tech/financial-modeling/skills/dcf-model/SKILL.md +1210 -1210
  123. package/skills/tech/financial-modeling/skills/dcf-model/TROUBLESHOOTING.md +40 -40
  124. package/skills/tech/financial-modeling/skills/dcf-model/requirements.txt +8 -8
  125. package/skills/tech/financial-modeling/skills/dcf-model/scripts/validate_dcf.py +292 -292
  126. package/skills/tech/financial-modeling/skills/lbo-model/SKILL.md +236 -236
  127. package/skills/tech/financial-modeling/skills/merger-model/SKILL.md +108 -108
  128. package/skills/workflows/README.md +203 -203
  129. package/skills/workflows/adr.md +174 -174
  130. package/skills/workflows/changelog.md +74 -74
  131. package/skills/workflows/compound.md +323 -323
  132. package/skills/workflows/compound_health.md +74 -74
  133. package/skills/workflows/create-agent-skill.md +138 -138
  134. package/skills/workflows/cycle.md +144 -144
  135. package/skills/workflows/deploy-docs.md +84 -84
  136. package/skills/workflows/development-rules.md +42 -42
  137. package/skills/workflows/doc.md +95 -95
  138. package/skills/workflows/documentation-management.md +34 -34
  139. package/skills/workflows/explore.md +146 -146
  140. package/skills/workflows/generate_command.md +106 -106
  141. package/skills/workflows/heal-skill.md +97 -97
  142. package/skills/workflows/housekeeping.md +229 -229
  143. package/skills/workflows/kit-setup.md +102 -102
  144. package/skills/workflows/map-codebase.md +78 -78
  145. package/skills/workflows/orchestration-protocol.md +43 -43
  146. package/skills/workflows/plan-compound.md +439 -439
  147. package/skills/workflows/plan_review.md +269 -269
  148. package/skills/workflows/primary-workflow.md +37 -37
  149. package/skills/workflows/promote_pattern.md +86 -86
  150. package/skills/workflows/release-docs.md +82 -82
  151. package/skills/workflows/report-bug.md +135 -135
  152. package/skills/workflows/reproduce-bug.md +118 -118
  153. package/skills/workflows/resolve_pr.md +133 -133
  154. package/skills/workflows/resolve_todo.md +128 -128
  155. package/skills/workflows/review-compound.md +376 -376
  156. package/skills/workflows/skill-review.md +127 -127
  157. package/skills/workflows/specs.md +257 -257
  158. package/skills/workflows/triage-sprint.md +102 -102
  159. package/skills/workflows/triage.md +152 -152
  160. package/skills/workflows/work.md +399 -399
  161. package/skills/workflows/xcode-test.md +93 -93
@@ -1,292 +1,292 @@
1
- # Formula Reference
2
-
3
- **IMPORTANT:** Use the formulas outlined in this reference document unless otherwise specified by the user.
4
-
5
- ---
6
-
7
- ## Core Linkages
8
-
9
- ```
10
- Balance Sheet: Assets = Liabilities + Equity
11
- Net Income: IS Net Income → CF Operations (starting point)
12
- Cash Flow: ΔCash = CFO + CFI + CFF
13
- Cash Tie-Out: Ending Cash (CF) = Cash (BS Asset)
14
- Cash Monthly/Annual: Closing Cash (Monthly) = Closing Cash (Annual)
15
- Retained Earnings: Prior RE + Net Income - Dividends = Ending RE
16
- Equity Raise: ΔCommon Stock/APIC (BS) = Equity Issuance (CFF)
17
- Year 0 Equity: Equity Raised (Year 0) = Beginning Equity (Year 1)
18
- ```
19
-
20
- ## Gross Profit Calculation
21
-
22
- **IMPORTANT:** Gross Profit must be calculated from Net Revenue, not Gross Revenue.
23
-
24
- ```
25
- Net Revenue - Cost of Revenue = Gross Profit
26
- ```
27
-
28
- | Term | Definition |
29
- |------|------------|
30
- | Gross Revenue | Total revenue before any deductions |
31
- | Net Revenue | Gross Revenue - Returns - Allowances - Discounts |
32
- | Cost of Revenue | Direct costs attributable to production of goods/services sold |
33
- | Gross Profit | Net Revenue - Cost of Revenue |
34
-
35
- **Note:** Always use Net Revenue (also called "Net Sales" or simply "Revenue" on most financial statements) as the starting point for profitability calculations. Gross Revenue overstates the true top-line performance.
36
-
37
- ## Margin Formulas
38
-
39
- ```
40
- Gross Margin % = Gross Profit / Net Revenue
41
- EBITDA = EBIT + D&A (or = Gross Profit - OpEx)
42
- EBITDA Margin % = EBITDA / Net Revenue
43
- EBIT Margin % = EBIT / Net Revenue
44
- Net Income Margin % = Net Income / Net Revenue
45
- ```
46
-
47
- ## Credit Metric Formulas
48
-
49
- ```
50
- Total Debt = Current Portion of Debt + Long-Term Debt
51
- Net Debt = Total Debt - Cash
52
- Total Debt / EBITDA = Total Debt / EBITDA (from IS)
53
- Net Debt / EBITDA = Net Debt / EBITDA (from IS)
54
- Interest Coverage = EBITDA / Interest Expense (from IS)
55
- Net Int Exp % Debt = Net Interest Expense / Long-Term Debt
56
- Debt / Total Cap = Total Debt / (Total Debt + Total Equity)
57
- Debt / Equity = Total Debt / Total Equity
58
- Current Ratio = Total Current Assets / Total Current Liabilities
59
- Quick Ratio = (Total Current Assets - Inventory) / Total Current Liabilities
60
- ```
61
-
62
- ## Forecast Formulas (% of Net Revenue Method)
63
-
64
- ```
65
- Cost of Revenue (Forecast) = Net Revenue × Cost of Revenue % Assumption
66
- S&M (Forecast) = Net Revenue × S&M % Assumption
67
- G&A (Forecast) = Net Revenue × G&A % Assumption
68
- R&D (Forecast) = Net Revenue × R&D % Assumption
69
- SBC (Forecast) = Net Revenue × SBC % Assumption
70
- ```
71
-
72
- ## Working Capital Formulas
73
-
74
- ```
75
- Accounts Receivable
76
- Prior AR
77
- + Revenue (from IS)
78
- - Cash Collections (plug)
79
- = Ending AR
80
- DSO = (AR / Revenue) × 365
81
-
82
- Inventory
83
- Prior Inventory
84
- + Purchases (plug)
85
- - COGS (from IS)
86
- = Ending Inventory
87
- DIO = (Inventory / COGS) × 365
88
-
89
- Accounts Payable
90
- Prior AP
91
- + Purchases (from Inventory calc)
92
- - Cash Payments (plug)
93
- = Ending AP
94
- DPO = (AP / COGS) × 365
95
-
96
- Net Working Capital = AR + Inventory - AP
97
- ΔWC = Current NWC - Prior NWC
98
- ```
99
-
100
- ## D&A Schedule Formulas
101
-
102
- ```
103
- Beginning PP&E (Gross)
104
- + CapEx
105
- = Ending PP&E (Gross)
106
-
107
- Beginning Accumulated Depreciation
108
- + Depreciation Expense
109
- = Ending Accumulated Depreciation
110
-
111
- PP&E (Net) = Gross PP&E - Accumulated Depreciation
112
- ```
113
-
114
- ## Debt Schedule Formulas
115
-
116
- ```
117
- Beginning Debt Balance
118
- + New Borrowings
119
- - Repayments
120
- = Ending Debt Balance
121
-
122
- Interest Expense = Avg Debt Balance × Interest Rate
123
- (Use beginning balance to avoid circularity, or iterate if circular refs enabled)
124
- ```
125
-
126
- ## Retained Earnings Formula
127
-
128
- ```
129
- Beginning Retained Earnings
130
- + Net Income (from IS)
131
- + Stock-Based Compensation (SBC) (from IS)
132
- - Dividends
133
- = Ending Retained Earnings
134
- ```
135
-
136
- ## NOL (Net Operating Loss) Schedule Formulas
137
-
138
- ```
139
- NOL CARRYFORWARD SCHEDULE
140
-
141
- Beginning NOL Balance (Year 1 / Formation = 0)
142
- + NOL Generated (if EBT < 0, then ABS(EBT), else 0)
143
- - NOL Utilized (limited by taxable income and utilization cap)
144
- = Ending NOL Balance
145
-
146
- STARTING BALANCE RULE
147
-
148
- For a new business or first modeled period:
149
- Beginning NOL Balance = 0
150
- NOL can only increase through realized losses (EBT < 0)
151
- NOL cannot be created from thin air or assumed
152
-
153
- NOL UTILIZATION CALCULATION
154
-
155
- Pre-Tax Income (EBT)
156
- If EBT > 0:
157
- NOL Available = Beginning NOL Balance
158
- Utilization Limit = EBT × 80% (post-2017 federal limit)
159
- NOL Utilized = MIN(NOL Available, Utilization Limit)
160
- Taxable Income = EBT - NOL Utilized
161
- If EBT ≤ 0:
162
- NOL Utilized = 0
163
- Taxable Income = 0
164
- NOL Generated = ABS(EBT)
165
-
166
- TAX CALCULATION WITH NOL
167
-
168
- Taxes Payable = MAX(0, Taxable Income × Tax Rate)
169
- (Taxes cannot be negative; losses create NOL asset instead)
170
-
171
- DEFERRED TAX ASSET (DTA) FOR NOL
172
-
173
- DTA - NOL Carryforward = Ending NOL Balance × Tax Rate
174
- ΔDTA = Current DTA - Prior DTA
175
- (Increase in DTA = non-cash benefit on CF)
176
- (Decrease in DTA = non-cash expense on CF)
177
- ```
178
-
179
- ## Balance Sheet Structure
180
-
181
- ```
182
- ASSETS
183
- Cash (from CF ending cash)
184
- Accounts Receivable (from WC)
185
- Inventory (from WC)
186
- Total Current Assets
187
-
188
- PP&E, Net (from DA)
189
- Deferred Tax Asset - NOL (from NOL schedule)
190
- Total Non-Current Assets
191
- Total Assets
192
-
193
- LIABILITIES
194
- Accounts Payable (from WC)
195
- Current Portion of Debt (from Debt)
196
- Total Current Liabilities
197
-
198
- Long-Term Debt (from Debt)
199
- Total Liabilities
200
-
201
- EQUITY
202
- Common Stock
203
- Retained Earnings (from RE schedule)
204
- Total Equity
205
-
206
- CHECK: Assets - Liabilities - Equity = 0
207
- ```
208
-
209
- ## Cash Flow Statement Structure
210
-
211
- ```
212
- CASH FROM OPERATIONS (CFO)
213
- Net Income (LINK: IS)
214
- + D&A (LINK: DA schedule)
215
- + Stock-Based Compensation (SBC) (LINK: IS or Assumptions)
216
- - ΔDTA (Deferred Tax Asset) (LINK: NOL schedule; increase in DTA = use of cash)
217
- - ΔAR (LINK: WC)
218
- - ΔInventory (LINK: WC)
219
- + ΔAP (LINK: WC)
220
- = CFO
221
-
222
- CASH FROM INVESTING (CFI)
223
- - CapEx (LINK: DA schedule)
224
- = CFI
225
-
226
- CASH FROM FINANCING (CFF)
227
- + Debt Issuance (LINK: Debt)
228
- - Debt Repayment (LINK: Debt)
229
- + Equity Issuance (LINK: BS Common Stock/APIC)
230
- - Dividends (LINK: RE schedule)
231
- = CFF
232
-
233
- Net Change in Cash = CFO + CFI + CFF
234
- Beginning Cash
235
- + Net Change in Cash
236
- = Ending Cash (LINK TO: BS Cash)
237
- ```
238
-
239
- ## Income Statement Structure
240
-
241
- ```
242
- Net Revenue
243
- Growth %
244
- (-) Cost of Revenue
245
- % of Net Revenue
246
- ────────────────
247
- Gross Profit (= Net Revenue - Cost of Revenue)
248
- Gross Margin %
249
-
250
- (-) S&M
251
- % of Net Revenue
252
- (-) G&A
253
- % of Net Revenue
254
- (-) R&D
255
- % of Net Revenue
256
- (-) D&A
257
- (-) SBC
258
- % of Net Revenue
259
- ────────────────
260
- EBIT
261
- EBIT Margin %
262
-
263
- EBITDA
264
- EBITDA Margin %
265
-
266
- (-) Interest Expense
267
- ────────────────
268
- EBT (Pre-Tax Income)
269
- (-) NOL Utilization (from NOL schedule, reduces taxable income)
270
- ────────────────
271
- Taxable Income
272
- (-) Taxes (Taxable Income × Tax Rate)
273
- ────────────────
274
- Net Income
275
- Net Income Margin %
276
- ```
277
-
278
- ## Check Formulas
279
-
280
- ```
281
- BS Balance Check: = Assets - Liabilities - Equity (must = 0)
282
- Cash Tie-Out: = BS Cash - CF Ending Cash (must = 0)
283
- RE Roll-Forward: = Prior RE + NI + SBC - Div - BS RE (must = 0)
284
- DTA Tie-Out: = NOL Schedule DTA - BS DTA (must = 0)
285
- Equity Raise Tie-Out: = ΔCommon Stock/APIC (BS) - Equity Issuance (CFF) (must = 0)
286
- Year 0 Equity Tie-Out: = Equity Raised (Year 0) - Beginning Equity (Year 1) (must = 0)
287
- Cash Monthly vs Annual: = Closing Cash (Monthly) - Closing Cash (Annual) (must = 0)
288
- NOL Utilization Cap: = NOL Utilized ≤ EBT × 80% (must be TRUE for post-2017)
289
- NOL Non-Negative: = Ending NOL Balance ≥ 0 (must be TRUE)
290
- NOL Starting Balance: = Beginning NOL (Year 1) = 0 (must be TRUE for new business)
291
- NOL Accumulation: = NOL increases only when EBT < 0 (losses generate NOL)
292
- ```
1
+ # Formula Reference
2
+
3
+ **IMPORTANT:** Use the formulas outlined in this reference document unless otherwise specified by the user.
4
+
5
+ ---
6
+
7
+ ## Core Linkages
8
+
9
+ ```
10
+ Balance Sheet: Assets = Liabilities + Equity
11
+ Net Income: IS Net Income → CF Operations (starting point)
12
+ Cash Flow: ΔCash = CFO + CFI + CFF
13
+ Cash Tie-Out: Ending Cash (CF) = Cash (BS Asset)
14
+ Cash Monthly/Annual: Closing Cash (Monthly) = Closing Cash (Annual)
15
+ Retained Earnings: Prior RE + Net Income - Dividends = Ending RE
16
+ Equity Raise: ΔCommon Stock/APIC (BS) = Equity Issuance (CFF)
17
+ Year 0 Equity: Equity Raised (Year 0) = Beginning Equity (Year 1)
18
+ ```
19
+
20
+ ## Gross Profit Calculation
21
+
22
+ **IMPORTANT:** Gross Profit must be calculated from Net Revenue, not Gross Revenue.
23
+
24
+ ```
25
+ Net Revenue - Cost of Revenue = Gross Profit
26
+ ```
27
+
28
+ | Term | Definition |
29
+ |------|------------|
30
+ | Gross Revenue | Total revenue before any deductions |
31
+ | Net Revenue | Gross Revenue - Returns - Allowances - Discounts |
32
+ | Cost of Revenue | Direct costs attributable to production of goods/services sold |
33
+ | Gross Profit | Net Revenue - Cost of Revenue |
34
+
35
+ **Note:** Always use Net Revenue (also called "Net Sales" or simply "Revenue" on most financial statements) as the starting point for profitability calculations. Gross Revenue overstates the true top-line performance.
36
+
37
+ ## Margin Formulas
38
+
39
+ ```
40
+ Gross Margin % = Gross Profit / Net Revenue
41
+ EBITDA = EBIT + D&A (or = Gross Profit - OpEx)
42
+ EBITDA Margin % = EBITDA / Net Revenue
43
+ EBIT Margin % = EBIT / Net Revenue
44
+ Net Income Margin % = Net Income / Net Revenue
45
+ ```
46
+
47
+ ## Credit Metric Formulas
48
+
49
+ ```
50
+ Total Debt = Current Portion of Debt + Long-Term Debt
51
+ Net Debt = Total Debt - Cash
52
+ Total Debt / EBITDA = Total Debt / EBITDA (from IS)
53
+ Net Debt / EBITDA = Net Debt / EBITDA (from IS)
54
+ Interest Coverage = EBITDA / Interest Expense (from IS)
55
+ Net Int Exp % Debt = Net Interest Expense / Long-Term Debt
56
+ Debt / Total Cap = Total Debt / (Total Debt + Total Equity)
57
+ Debt / Equity = Total Debt / Total Equity
58
+ Current Ratio = Total Current Assets / Total Current Liabilities
59
+ Quick Ratio = (Total Current Assets - Inventory) / Total Current Liabilities
60
+ ```
61
+
62
+ ## Forecast Formulas (% of Net Revenue Method)
63
+
64
+ ```
65
+ Cost of Revenue (Forecast) = Net Revenue × Cost of Revenue % Assumption
66
+ S&M (Forecast) = Net Revenue × S&M % Assumption
67
+ G&A (Forecast) = Net Revenue × G&A % Assumption
68
+ R&D (Forecast) = Net Revenue × R&D % Assumption
69
+ SBC (Forecast) = Net Revenue × SBC % Assumption
70
+ ```
71
+
72
+ ## Working Capital Formulas
73
+
74
+ ```
75
+ Accounts Receivable
76
+ Prior AR
77
+ + Revenue (from IS)
78
+ - Cash Collections (plug)
79
+ = Ending AR
80
+ DSO = (AR / Revenue) × 365
81
+
82
+ Inventory
83
+ Prior Inventory
84
+ + Purchases (plug)
85
+ - COGS (from IS)
86
+ = Ending Inventory
87
+ DIO = (Inventory / COGS) × 365
88
+
89
+ Accounts Payable
90
+ Prior AP
91
+ + Purchases (from Inventory calc)
92
+ - Cash Payments (plug)
93
+ = Ending AP
94
+ DPO = (AP / COGS) × 365
95
+
96
+ Net Working Capital = AR + Inventory - AP
97
+ ΔWC = Current NWC - Prior NWC
98
+ ```
99
+
100
+ ## D&A Schedule Formulas
101
+
102
+ ```
103
+ Beginning PP&E (Gross)
104
+ + CapEx
105
+ = Ending PP&E (Gross)
106
+
107
+ Beginning Accumulated Depreciation
108
+ + Depreciation Expense
109
+ = Ending Accumulated Depreciation
110
+
111
+ PP&E (Net) = Gross PP&E - Accumulated Depreciation
112
+ ```
113
+
114
+ ## Debt Schedule Formulas
115
+
116
+ ```
117
+ Beginning Debt Balance
118
+ + New Borrowings
119
+ - Repayments
120
+ = Ending Debt Balance
121
+
122
+ Interest Expense = Avg Debt Balance × Interest Rate
123
+ (Use beginning balance to avoid circularity, or iterate if circular refs enabled)
124
+ ```
125
+
126
+ ## Retained Earnings Formula
127
+
128
+ ```
129
+ Beginning Retained Earnings
130
+ + Net Income (from IS)
131
+ + Stock-Based Compensation (SBC) (from IS)
132
+ - Dividends
133
+ = Ending Retained Earnings
134
+ ```
135
+
136
+ ## NOL (Net Operating Loss) Schedule Formulas
137
+
138
+ ```
139
+ NOL CARRYFORWARD SCHEDULE
140
+
141
+ Beginning NOL Balance (Year 1 / Formation = 0)
142
+ + NOL Generated (if EBT < 0, then ABS(EBT), else 0)
143
+ - NOL Utilized (limited by taxable income and utilization cap)
144
+ = Ending NOL Balance
145
+
146
+ STARTING BALANCE RULE
147
+
148
+ For a new business or first modeled period:
149
+ Beginning NOL Balance = 0
150
+ NOL can only increase through realized losses (EBT < 0)
151
+ NOL cannot be created from thin air or assumed
152
+
153
+ NOL UTILIZATION CALCULATION
154
+
155
+ Pre-Tax Income (EBT)
156
+ If EBT > 0:
157
+ NOL Available = Beginning NOL Balance
158
+ Utilization Limit = EBT × 80% (post-2017 federal limit)
159
+ NOL Utilized = MIN(NOL Available, Utilization Limit)
160
+ Taxable Income = EBT - NOL Utilized
161
+ If EBT ≤ 0:
162
+ NOL Utilized = 0
163
+ Taxable Income = 0
164
+ NOL Generated = ABS(EBT)
165
+
166
+ TAX CALCULATION WITH NOL
167
+
168
+ Taxes Payable = MAX(0, Taxable Income × Tax Rate)
169
+ (Taxes cannot be negative; losses create NOL asset instead)
170
+
171
+ DEFERRED TAX ASSET (DTA) FOR NOL
172
+
173
+ DTA - NOL Carryforward = Ending NOL Balance × Tax Rate
174
+ ΔDTA = Current DTA - Prior DTA
175
+ (Increase in DTA = non-cash benefit on CF)
176
+ (Decrease in DTA = non-cash expense on CF)
177
+ ```
178
+
179
+ ## Balance Sheet Structure
180
+
181
+ ```
182
+ ASSETS
183
+ Cash (from CF ending cash)
184
+ Accounts Receivable (from WC)
185
+ Inventory (from WC)
186
+ Total Current Assets
187
+
188
+ PP&E, Net (from DA)
189
+ Deferred Tax Asset - NOL (from NOL schedule)
190
+ Total Non-Current Assets
191
+ Total Assets
192
+
193
+ LIABILITIES
194
+ Accounts Payable (from WC)
195
+ Current Portion of Debt (from Debt)
196
+ Total Current Liabilities
197
+
198
+ Long-Term Debt (from Debt)
199
+ Total Liabilities
200
+
201
+ EQUITY
202
+ Common Stock
203
+ Retained Earnings (from RE schedule)
204
+ Total Equity
205
+
206
+ CHECK: Assets - Liabilities - Equity = 0
207
+ ```
208
+
209
+ ## Cash Flow Statement Structure
210
+
211
+ ```
212
+ CASH FROM OPERATIONS (CFO)
213
+ Net Income (LINK: IS)
214
+ + D&A (LINK: DA schedule)
215
+ + Stock-Based Compensation (SBC) (LINK: IS or Assumptions)
216
+ - ΔDTA (Deferred Tax Asset) (LINK: NOL schedule; increase in DTA = use of cash)
217
+ - ΔAR (LINK: WC)
218
+ - ΔInventory (LINK: WC)
219
+ + ΔAP (LINK: WC)
220
+ = CFO
221
+
222
+ CASH FROM INVESTING (CFI)
223
+ - CapEx (LINK: DA schedule)
224
+ = CFI
225
+
226
+ CASH FROM FINANCING (CFF)
227
+ + Debt Issuance (LINK: Debt)
228
+ - Debt Repayment (LINK: Debt)
229
+ + Equity Issuance (LINK: BS Common Stock/APIC)
230
+ - Dividends (LINK: RE schedule)
231
+ = CFF
232
+
233
+ Net Change in Cash = CFO + CFI + CFF
234
+ Beginning Cash
235
+ + Net Change in Cash
236
+ = Ending Cash (LINK TO: BS Cash)
237
+ ```
238
+
239
+ ## Income Statement Structure
240
+
241
+ ```
242
+ Net Revenue
243
+ Growth %
244
+ (-) Cost of Revenue
245
+ % of Net Revenue
246
+ ────────────────
247
+ Gross Profit (= Net Revenue - Cost of Revenue)
248
+ Gross Margin %
249
+
250
+ (-) S&M
251
+ % of Net Revenue
252
+ (-) G&A
253
+ % of Net Revenue
254
+ (-) R&D
255
+ % of Net Revenue
256
+ (-) D&A
257
+ (-) SBC
258
+ % of Net Revenue
259
+ ────────────────
260
+ EBIT
261
+ EBIT Margin %
262
+
263
+ EBITDA
264
+ EBITDA Margin %
265
+
266
+ (-) Interest Expense
267
+ ────────────────
268
+ EBT (Pre-Tax Income)
269
+ (-) NOL Utilization (from NOL schedule, reduces taxable income)
270
+ ────────────────
271
+ Taxable Income
272
+ (-) Taxes (Taxable Income × Tax Rate)
273
+ ────────────────
274
+ Net Income
275
+ Net Income Margin %
276
+ ```
277
+
278
+ ## Check Formulas
279
+
280
+ ```
281
+ BS Balance Check: = Assets - Liabilities - Equity (must = 0)
282
+ Cash Tie-Out: = BS Cash - CF Ending Cash (must = 0)
283
+ RE Roll-Forward: = Prior RE + NI + SBC - Div - BS RE (must = 0)
284
+ DTA Tie-Out: = NOL Schedule DTA - BS DTA (must = 0)
285
+ Equity Raise Tie-Out: = ΔCommon Stock/APIC (BS) - Equity Issuance (CFF) (must = 0)
286
+ Year 0 Equity Tie-Out: = Equity Raised (Year 0) - Beginning Equity (Year 1) (must = 0)
287
+ Cash Monthly vs Annual: = Closing Cash (Monthly) - Closing Cash (Annual) (must = 0)
288
+ NOL Utilization Cap: = NOL Utilized ≤ EBT × 80% (must be TRUE for post-2017)
289
+ NOL Non-Negative: = Ending NOL Balance ≥ 0 (must be TRUE)
290
+ NOL Starting Balance: = Beginning NOL (Year 1) = 0 (must be TRUE for new business)
291
+ NOL Accumulation: = NOL increases only when EBT < 0 (losses generate NOL)
292
+ ```