sinapse-ai 9.3.0 → 9.5.0

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 (432) hide show
  1. package/.claude/CLAUDE.md +60 -341
  2. package/.claude/hooks/enforce-architecture-first.py +197 -197
  3. package/.claude/hooks/enforce-git-push-authority.sh +25 -4
  4. package/.claude/hooks/mind-clone-governance.py +193 -193
  5. package/.claude/hooks/read-protection.py +152 -152
  6. package/.claude/hooks/sql-governance.py +183 -183
  7. package/.claude/hooks/verify-packages.cjs +83 -0
  8. package/.claude/hooks/write-path-validation.py +195 -195
  9. package/.claude/rules/agent-authority.md +6 -0
  10. package/.claude/rules/agent-handoff.md +5 -0
  11. package/.claude/rules/cross-squad-routing.md +5 -0
  12. package/.claude/rules/hook-governance.md +7 -0
  13. package/.claude/rules/mandatory-delegation.md +24 -0
  14. package/.claude/rules/mcp-usage.md +3 -1
  15. package/.claude/rules/project-intelligence.md +63 -0
  16. package/.claude/rules/response-format.md +4 -0
  17. package/.claude/rules/safe-collaboration.md +14 -2
  18. package/.claude/rules/security-data-protection.md +27 -0
  19. package/.claude/rules/squad-awareness.md +96 -68
  20. package/.claude/rules/token-economy.md +148 -0
  21. package/.claude/rules/tool-examples.md +6 -0
  22. package/.claude/rules/workflow-execution.md +7 -0
  23. package/.codex/agents/analyst.md +342 -71
  24. package/.codex/agents/architect.md +533 -68
  25. package/.codex/agents/data-engineer.md +530 -106
  26. package/.codex/agents/developer.md +657 -0
  27. package/.codex/agents/devops.md +639 -69
  28. package/.codex/agents/product-lead.md +362 -0
  29. package/.codex/agents/project-lead.md +405 -0
  30. package/.codex/agents/quality-gate.md +538 -0
  31. package/.codex/agents/sinapse-orqx.md +9 -7
  32. package/.codex/agents/sprint-lead.md +315 -0
  33. package/.codex/agents/squad-creator.md +402 -0
  34. package/.codex/agents/ux-design-expert.md +523 -0
  35. package/.codex/delegation-matrix.json +756 -44
  36. package/.codex/handoff-packet.schema.json +30 -6
  37. package/.sinapse-ai/core/code-intel/registry-syncer.js +56 -3
  38. package/.sinapse-ai/core/doctor/checks/agent-memory.js +5 -1
  39. package/.sinapse-ai/core/doctor/checks/claude-md.js +4 -1
  40. package/.sinapse-ai/core/doctor/checks/code-intel.js +5 -1
  41. package/.sinapse-ai/core/doctor/checks/commands-count.js +4 -1
  42. package/.sinapse-ai/core/doctor/checks/constitution-consistency.js +4 -1
  43. package/.sinapse-ai/core/doctor/checks/core-config.js +4 -1
  44. package/.sinapse-ai/core/doctor/checks/entity-registry.js +6 -1
  45. package/.sinapse-ai/core/doctor/checks/git-hooks.js +5 -1
  46. package/.sinapse-ai/core/doctor/checks/graph-dashboard.js +4 -1
  47. package/.sinapse-ai/core/doctor/checks/hooks-claude-count.js +5 -1
  48. package/.sinapse-ai/core/doctor/checks/ide-sync.js +4 -1
  49. package/.sinapse-ai/core/doctor/checks/node-version.js +4 -1
  50. package/.sinapse-ai/core/doctor/checks/npm-packages.js +4 -1
  51. package/.sinapse-ai/core/doctor/checks/rules-files.js +4 -1
  52. package/.sinapse-ai/core/doctor/checks/settings-json.js +4 -1
  53. package/.sinapse-ai/core/doctor/checks/skills-count.js +4 -1
  54. package/.sinapse-ai/core/doctor/index.js +157 -50
  55. package/.sinapse-ai/core/ids/registry-updater.js +6 -1
  56. package/.sinapse-ai/core/logger/index.js +319 -0
  57. package/.sinapse-ai/core/orchestration/terminal-spawner.js +2 -2
  58. package/.sinapse-ai/core/telemetry/index.js +247 -0
  59. package/.sinapse-ai/data/entity-registry.yaml +1060 -808
  60. package/.sinapse-ai/development/agents/analyst.md +90 -0
  61. package/.sinapse-ai/development/agents/architect.md +78 -0
  62. package/.sinapse-ai/development/agents/data-engineer.md +38 -0
  63. package/.sinapse-ai/development/agents/developer.md +97 -0
  64. package/.sinapse-ai/development/agents/devops.md +121 -0
  65. package/.sinapse-ai/development/agents/product-lead.md +27 -0
  66. package/.sinapse-ai/development/agents/project-lead.md +28 -0
  67. package/.sinapse-ai/development/agents/quality-gate.md +89 -0
  68. package/.sinapse-ai/development/agents/sprint-lead/MEMORY.md +8 -0
  69. package/.sinapse-ai/development/agents/sprint-lead.md +28 -0
  70. package/.sinapse-ai/development/agents/squad-creator.md +58 -0
  71. package/.sinapse-ai/development/agents/ux-design-expert.md +28 -0
  72. package/.sinapse-ai/development/checklists/agent-quality-gate.md +27 -0
  73. package/.sinapse-ai/development/checklists/brownfield-compatibility-checklist.md +20 -0
  74. package/.sinapse-ai/development/checklists/code-review-checklist.md +106 -0
  75. package/.sinapse-ai/development/checklists/issue-triage-checklist.md +9 -0
  76. package/.sinapse-ai/development/checklists/memory-audit-checklist.md +16 -0
  77. package/.sinapse-ai/development/checklists/pr-quality-checklist.md +72 -0
  78. package/.sinapse-ai/development/checklists/security-deployment-checklist.md +54 -0
  79. package/.sinapse-ai/development/checklists/self-critique-checklist.md +19 -1
  80. package/.sinapse-ai/development/knowledge-base/agent-communication-protocol.md +127 -0
  81. package/.sinapse-ai/development/knowledge-base/database-scaling-patterns.md +374 -0
  82. package/.sinapse-ai/development/knowledge-base/environment-deployment-patterns.md +353 -0
  83. package/.sinapse-ai/development/knowledge-base/gotchas-patterns.md +224 -0
  84. package/.sinapse-ai/development/knowledge-base/infrastructure-decision-framework.md +221 -0
  85. package/.sinapse-ai/development/knowledge-base/security-pre-deploy-checklist.md +410 -0
  86. package/.sinapse-ai/development/knowledge-base/software-architecture-patterns.md +299 -0
  87. package/.sinapse-ai/development/knowledge-base/token-economy-guide.md +198 -0
  88. package/.sinapse-ai/development/scripts/populate-entity-registry.js +5 -1
  89. package/.sinapse-ai/development/skills/captcha-handler.md +82 -0
  90. package/.sinapse-ai/development/skills/chrome-brain.md +81 -0
  91. package/.sinapse-ai/development/skills/debug.md +57 -0
  92. package/.sinapse-ai/development/skills/deploy-readiness.md +93 -0
  93. package/.sinapse-ai/development/skills/fast-review.md +69 -0
  94. package/.sinapse-ai/development/skills/model-router.md +92 -0
  95. package/.sinapse-ai/development/skills/research-synthesis.md +77 -0
  96. package/.sinapse-ai/development/skills/security-scan.md +73 -0
  97. package/.sinapse-ai/development/skills/sinapse-methodology.md +175 -0
  98. package/.sinapse-ai/development/skills/story-fast-track.md +71 -0
  99. package/.sinapse-ai/development/skills/verify.md +53 -0
  100. package/.sinapse-ai/development/tasks/dev-develop-story.md +10 -0
  101. package/.sinapse-ai/development/tasks/environment-promotion-pipeline.md +582 -0
  102. package/.sinapse-ai/development/tasks/generate-agent-handoff.md +223 -0
  103. package/.sinapse-ai/development/tasks/infrastructure-assessment.md +432 -0
  104. package/.sinapse-ai/development/tasks/load-testing-setup.md +611 -0
  105. package/.sinapse-ai/development/tasks/observability-blueprint.md +562 -0
  106. package/.sinapse-ai/development/templates/legal/breach-notification-tmpl.md +113 -0
  107. package/.sinapse-ai/development/templates/legal/privacy-policy-tmpl.md +93 -0
  108. package/.sinapse-ai/development/templates/legal/terms-of-service-tmpl.md +85 -0
  109. package/.sinapse-ai/development/templates/service-template/README.md.hbs +159 -159
  110. package/.sinapse-ai/development/templates/service-template/__tests__/index.test.ts.hbs +238 -238
  111. package/.sinapse-ai/development/templates/service-template/client.ts.hbs +404 -404
  112. package/.sinapse-ai/development/templates/service-template/errors.ts.hbs +183 -183
  113. package/.sinapse-ai/development/templates/service-template/index.ts.hbs +121 -121
  114. package/.sinapse-ai/development/templates/service-template/package.json.hbs +88 -88
  115. package/.sinapse-ai/development/templates/service-template/types.ts.hbs +146 -146
  116. package/.sinapse-ai/development/templates/squad/agent-template.md +17 -4
  117. package/.sinapse-ai/development/templates/squad/checklist-template.md +13 -5
  118. package/.sinapse-ai/development/templates/squad/task-template.md +7 -0
  119. package/.sinapse-ai/development/templates/squad/workflow-template.yaml +7 -0
  120. package/.sinapse-ai/development/templates/squad-template/LICENSE +22 -22
  121. package/.sinapse-ai/development/workflows/fast-track.yaml +87 -0
  122. package/.sinapse-ai/development/workflows/story-development-cycle.yaml +40 -1
  123. package/.sinapse-ai/hooks/ids-post-commit.js +22 -0
  124. package/.sinapse-ai/infrastructure/contracts/compatibility/README.md +42 -0
  125. package/.sinapse-ai/infrastructure/contracts/compatibility/sinapse-current.yaml +35 -0
  126. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/claude-free-tracked.cmd +127 -127
  127. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-proxy.cmd +71 -71
  128. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-usage.cmd +51 -51
  129. package/.sinapse-ai/infrastructure/scripts/pr-review-ai.js +16 -13
  130. package/.sinapse-ai/infrastructure/scripts/setup-project-infra.js +128 -0
  131. package/.sinapse-ai/infrastructure/scripts/test-discovery.js +8 -3
  132. package/.sinapse-ai/infrastructure/scripts/validate-codex-delegation.js +3 -1
  133. package/.sinapse-ai/infrastructure/scripts/validate-manifest-parity.js +380 -0
  134. package/.sinapse-ai/infrastructure/scripts/validate-parity.js +76 -25
  135. package/.sinapse-ai/infrastructure/templates/coderabbit.yaml.template +280 -280
  136. package/.sinapse-ai/infrastructure/templates/config/env.example +16 -0
  137. package/.sinapse-ai/infrastructure/templates/config/gitignore-additions.tmpl +59 -0
  138. package/.sinapse-ai/infrastructure/templates/github/CODEOWNERS.template +12 -0
  139. package/.sinapse-ai/infrastructure/templates/github/PULL_REQUEST_TEMPLATE.md +29 -0
  140. package/.sinapse-ai/infrastructure/templates/github/ci-template.yml +77 -0
  141. package/.sinapse-ai/infrastructure/templates/github/issue-templates/bug_report.md +34 -0
  142. package/.sinapse-ai/infrastructure/templates/github/issue-templates/feature_request.md +19 -0
  143. package/.sinapse-ai/infrastructure/templates/github-workflows/ci.yml.template +170 -170
  144. package/.sinapse-ai/infrastructure/templates/github-workflows/pr-automation.yml.template +331 -331
  145. package/.sinapse-ai/infrastructure/templates/github-workflows/release.yml.template +197 -197
  146. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl +19 -19
  147. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-node.tmpl +86 -86
  148. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-python.tmpl +146 -146
  149. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-sinapse-base.tmpl +64 -64
  150. package/.sinapse-ai/infrastructure/templates/sinapse-sync.yaml.template +183 -183
  151. package/.sinapse-ai/install-manifest.yaml +333 -162
  152. package/.sinapse-ai/local-config.yaml.template +65 -65
  153. package/.sinapse-ai/monitor/hooks/lib/__init__.py +2 -2
  154. package/.sinapse-ai/monitor/hooks/lib/enrich.py +59 -59
  155. package/.sinapse-ai/monitor/hooks/lib/send_event.py +48 -48
  156. package/.sinapse-ai/monitor/hooks/notification.py +30 -30
  157. package/.sinapse-ai/monitor/hooks/post_tool_use.py +46 -46
  158. package/.sinapse-ai/monitor/hooks/pre_compact.py +30 -30
  159. package/.sinapse-ai/monitor/hooks/pre_tool_use.py +41 -41
  160. package/.sinapse-ai/monitor/hooks/stop.py +30 -30
  161. package/.sinapse-ai/monitor/hooks/subagent_stop.py +30 -30
  162. package/.sinapse-ai/monitor/hooks/user_prompt_submit.py +39 -39
  163. package/.sinapse-ai/product/templates/adr.hbs +126 -126
  164. package/.sinapse-ai/product/templates/dbdr.hbs +242 -242
  165. package/.sinapse-ai/product/templates/epic.hbs +213 -213
  166. package/.sinapse-ai/product/templates/pmdr.hbs +187 -187
  167. package/.sinapse-ai/product/templates/prd-v2.0.hbs +217 -217
  168. package/.sinapse-ai/product/templates/prd.hbs +202 -202
  169. package/.sinapse-ai/product/templates/story-tmpl.yaml +59 -0
  170. package/.sinapse-ai/product/templates/story.hbs +264 -264
  171. package/.sinapse-ai/product/templates/task.hbs +171 -171
  172. package/.sinapse-ai/product/templates/tmpl-comment-on-examples.sql +159 -159
  173. package/.sinapse-ai/product/templates/tmpl-migration-script.sql +92 -92
  174. package/.sinapse-ai/product/templates/tmpl-rls-granular-policies.sql +105 -105
  175. package/.sinapse-ai/product/templates/tmpl-rls-kiss-policy.sql +11 -11
  176. package/.sinapse-ai/product/templates/tmpl-rls-roles.sql +136 -136
  177. package/.sinapse-ai/product/templates/tmpl-rls-simple.sql +78 -78
  178. package/.sinapse-ai/product/templates/tmpl-rls-tenant.sql +153 -153
  179. package/.sinapse-ai/product/templates/tmpl-rollback-script.sql +78 -78
  180. package/.sinapse-ai/product/templates/tmpl-seed-data.sql +141 -141
  181. package/.sinapse-ai/product/templates/tmpl-smoke-test.sql +17 -17
  182. package/.sinapse-ai/product/templates/tmpl-staging-copy-merge.sql +140 -140
  183. package/.sinapse-ai/product/templates/tmpl-stored-proc.sql +141 -141
  184. package/.sinapse-ai/product/templates/tmpl-trigger.sql +153 -153
  185. package/.sinapse-ai/product/templates/tmpl-view-materialized.sql +134 -134
  186. package/.sinapse-ai/product/templates/tmpl-view.sql +178 -178
  187. package/.sinapse-ai/scripts/diagnostics/health-dashboard/package-lock.json +427 -355
  188. package/LICENSE +34 -34
  189. package/README.en.md +167 -20
  190. package/README.md +190 -22
  191. package/bin/cli.js +510 -196
  192. package/bin/postinstall.js +564 -0
  193. package/bin/sinapse-cli +283 -283
  194. package/bin/sinapse-graph.js +9 -0
  195. package/bin/sinapse-init.js +36 -4
  196. package/bin/sinapse-minimal.js +20 -9
  197. package/bin/sinapse.js +202 -122
  198. package/bin/utils/deprecation-warning.js +46 -0
  199. package/bin/utils/pre-push-safety.js +14 -0
  200. package/docs/TELEMETRY.md +131 -0
  201. package/docs/chrome-brain-upgrade-plan.md +624 -0
  202. package/docs/codex-integration-process.md +22 -0
  203. package/docs/codex-parity-program.md +27 -0
  204. package/docs/framework/orqx-plan.md +1 -1
  205. package/docs/ide-integration.md +36 -0
  206. package/docs/installation/chrome-brain.md +17 -7
  207. package/docs/mega-upgrade-orchestration-plan.md +71 -0
  208. package/docs/pt/contributing.md +20 -0
  209. package/docs/research-synthesis-for-upgrade.md +511 -0
  210. package/docs/security-audit-report.md +306 -0
  211. package/package.json +20 -8
  212. package/packages/installer/src/config/configure-environment.js +19 -44
  213. package/packages/installer/src/detection/detect-project-type.js +181 -63
  214. package/packages/installer/src/installer/manifest-signature.js +32 -17
  215. package/packages/installer/src/wizard/i18n.js +12 -0
  216. package/packages/installer/src/wizard/ide-config-generator.js +8 -39
  217. package/packages/installer/src/wizard/index.js +119 -14
  218. package/packages/installer/src/wizard/questions.js +2 -3
  219. package/packages/installer/tests/integration/environment-configuration.test.js +7 -5
  220. package/packages/installer/tests/unit/detection/detect-project-type.test.js +138 -1
  221. package/packages/installer/tests/unit/doctor/doctor-orchestrator.test.js +3 -3
  222. package/packages/sinapse-install/bin/edmcp.js +0 -0
  223. package/packages/sinapse-install/bin/sinapse-install.js +0 -0
  224. package/packages/sinapse-pro-cli/bin/sinapse-pro.js +0 -0
  225. package/scripts/check-markdown-links.py +353 -353
  226. package/scripts/coverage-report-summary.js +169 -0
  227. package/scripts/generate-install-manifest.js +6 -2
  228. package/scripts/release-readiness.js +169 -0
  229. package/scripts/test-install-matrix-local.sh +153 -0
  230. package/scripts/validate-install-docs.js +394 -0
  231. package/scripts/validate-no-external-refs.js +376 -0
  232. package/scripts/validate-squad-orqx.js +302 -0
  233. package/scripts/validate-story-meta.js +263 -0
  234. package/squads/claude-code-mastery/CHANGELOG.md +1 -1
  235. package/squads/claude-code-mastery/README.md +2 -2
  236. package/squads/claude-code-mastery/knowledge-base/claude-code-internals-reference.md +927 -0
  237. package/squads/claude-code-mastery/squad.yaml +1 -1
  238. package/squads/squad-artdir/README.md +90 -0
  239. package/squads/squad-artdir/agents/accessibility-guardian.md +184 -0
  240. package/squads/squad-artdir/agents/artdir-orqx.md +145 -0
  241. package/squads/squad-artdir/agents/color-psychologist.md +166 -0
  242. package/squads/squad-artdir/agents/cro-persuasion.md +161 -0
  243. package/squads/squad-artdir/agents/design-system-architect.md +100 -0
  244. package/squads/squad-artdir/agents/ia-architect.md +169 -0
  245. package/squads/squad-artdir/agents/interaction-designer.md +162 -0
  246. package/squads/squad-artdir/agents/layout-engineer.md +163 -0
  247. package/squads/squad-artdir/agents/motion-architect.md +185 -0
  248. package/squads/squad-artdir/agents/platform-aesthetic-director.md +84 -0
  249. package/squads/squad-artdir/agents/premium-packaging-strategist.md +107 -0
  250. package/squads/squad-artdir/agents/product-surface-director.md +86 -0
  251. package/squads/squad-artdir/agents/type-systemist.md +138 -0
  252. package/squads/squad-artdir/agents/visual-strategist.md +127 -0
  253. package/squads/squad-artdir/checklists/seven-pillars-validation-checklist.md +172 -0
  254. package/squads/squad-artdir/knowledge-base/case-nyo-ia-reference.md +289 -0
  255. package/squads/squad-artdir/knowledge-base/deliverables-templates.md +457 -0
  256. package/squads/squad-artdir/knowledge-base/motion-technique-catalog.md +247 -0
  257. package/squads/squad-artdir/knowledge-base/premium-packaging-principles.md +133 -0
  258. package/squads/squad-artdir/knowledge-base/psychological-toolkit.md +229 -0
  259. package/squads/squad-artdir/knowledge-base/saas-art-direction-canon.md +242 -0
  260. package/squads/squad-artdir/knowledge-base/seven-pillars-framework.md +289 -0
  261. package/squads/squad-artdir/knowledge-base/ten-pillars-framework.md +221 -0
  262. package/squads/squad-artdir/package.json +20 -0
  263. package/squads/squad-artdir/squad.yaml +271 -0
  264. package/squads/squad-artdir/tasks/audit-conversion.md +97 -0
  265. package/squads/squad-artdir/tasks/audit-drift-multi-surface.md +55 -0
  266. package/squads/squad-artdir/tasks/consult-saas-canon.md +54 -0
  267. package/squads/squad-artdir/tasks/create-art-direction-brief.md +110 -0
  268. package/squads/squad-artdir/tasks/create-premium-packaging-brief.md +61 -0
  269. package/squads/squad-artdir/tasks/create-wireflow.md +84 -0
  270. package/squads/squad-artdir/tasks/design-color-system.md +81 -0
  271. package/squads/squad-artdir/tasks/design-product-surface.md +60 -0
  272. package/squads/squad-artdir/tasks/design-token-system.md +58 -0
  273. package/squads/squad-artdir/tasks/diagnose-visual-language.md +92 -0
  274. package/squads/squad-artdir/tasks/first-5-minutes-choreography.md +65 -0
  275. package/squads/squad-artdir/tasks/specify-motion-system.md +84 -0
  276. package/squads/squad-artdir/tasks/validate-against-pillars.md +143 -0
  277. package/squads/squad-artdir/templates/art-direction-brief-template.md +215 -0
  278. package/squads/squad-artdir/workflows/conversion-audit-cycle.yaml +78 -0
  279. package/squads/squad-artdir/workflows/full-art-direction-cycle.yaml +98 -0
  280. package/squads/squad-artdir/workflows/saas-platform-art-direction-cycle.yaml +174 -0
  281. package/squads/squad-brand/knowledge-base/ai-visual-generation-canon.md +234 -0
  282. package/squads/squad-brand/knowledge-base/archetype-brand-mapping.md +12 -1
  283. package/squads/squad-brand/knowledge-base/brand-activism-cultural-branding.md +216 -0
  284. package/squads/squad-brand/knowledge-base/brand-audit-criteria.md +58 -0
  285. package/squads/squad-brand/knowledge-base/brand-digital-strategy.md +188 -0
  286. package/squads/squad-brand/knowledge-base/brand-legal-ip.md +222 -0
  287. package/squads/squad-brand/knowledge-base/brand-naming-framework.md +163 -0
  288. package/squads/squad-brand/knowledge-base/branding-master-reference.md +1001 -0
  289. package/squads/squad-brand/knowledge-base/color-psychology.md +25 -12
  290. package/squads/squad-brand/knowledge-base/employer-personal-branding.md +206 -0
  291. package/squads/squad-brand/knowledge-base/routing-catalog.md +34 -0
  292. package/squads/squad-brand/knowledge-base/sonic-branding-principles.md +6 -1
  293. package/squads/squad-brand/knowledge-base/typography-personality.md +34 -0
  294. package/squads/squad-brand/squad.yaml +20 -6
  295. package/squads/squad-claude/knowledge-base/context-window-optimization.md +334 -0
  296. package/squads/squad-claude/knowledge-base/knowledge-architecture-reference.md +403 -0
  297. package/squads/squad-claude/knowledge-base/memory-systems-reference.md +412 -0
  298. package/squads/squad-claude/knowledge-base/obsidian-claude-integration.md +423 -0
  299. package/squads/squad-claude/knowledge-base/retrieval-augmented-generation.md +320 -0
  300. package/squads/squad-claude/knowledge-base/skill-creation-patterns.md +380 -0
  301. package/squads/squad-claude/knowledge-base/swarm-orchestration-patterns.md +411 -0
  302. package/squads/squad-cloning/knowledge-base/clone-quality-assurance.md +211 -0
  303. package/squads/squad-cloning/knowledge-base/confidence-scoring.md +51 -0
  304. package/squads/squad-cloning/knowledge-base/cross-squad-deployment.md +47 -0
  305. package/squads/squad-cloning/knowledge-base/ethical-guidelines.md +237 -0
  306. package/squads/squad-cloning/knowledge-base/knowledge-graph-for-clones.md +295 -0
  307. package/squads/squad-cloning/knowledge-base/memory-architecture-for-clones.md +229 -0
  308. package/squads/squad-cloning/knowledge-base/multi-agent-deployment-patterns.md +320 -0
  309. package/squads/squad-cloning/knowledge-base/skill-standard-for-clones.md +262 -0
  310. package/squads/squad-cloning/knowledge-base/sop-extraction-guide.md +243 -0
  311. package/squads/squad-commercial/knowledge-base/account-based-selling.md +206 -0
  312. package/squads/squad-commercial/knowledge-base/ai-as-competitive-infrastructure.md +14 -0
  313. package/squads/squad-commercial/knowledge-base/ai-in-sales.md +199 -0
  314. package/squads/squad-commercial/knowledge-base/brazilian-sales-context.md +195 -0
  315. package/squads/squad-commercial/knowledge-base/customer-success-operations.md +83 -2
  316. package/squads/squad-commercial/knowledge-base/prospecting-pipeline-generation.md +69 -0
  317. package/squads/squad-commercial/knowledge-base/sales-enablement-playbook.md +260 -0
  318. package/squads/squad-commercial/knowledge-base/sales-methodology-comparison.md +185 -0
  319. package/squads/squad-commercial/knowledge-base/sales-revenue-master-reference.md +1123 -0
  320. package/squads/squad-content/knowledge-base/ai-native-content-loop.md +220 -0
  321. package/squads/squad-content/knowledge-base/brazilian-content-context.md +176 -0
  322. package/squads/squad-content/knowledge-base/competitor-analysis-methods.md +40 -1
  323. package/squads/squad-content/knowledge-base/content-architecture-taxonomy.md +206 -0
  324. package/squads/squad-content/knowledge-base/content-formats-encyclopedia.md +58 -1
  325. package/squads/squad-content/knowledge-base/content-references-bibliography.md +130 -0
  326. package/squads/squad-content/knowledge-base/content-strategy-master-reference.md +1097 -0
  327. package/squads/squad-content/knowledge-base/content-tech-stack.md +150 -0
  328. package/squads/squad-content/knowledge-base/copywriting-formulas-library.md +188 -0
  329. package/squads/squad-content/knowledge-base/email-newsletter-strategy.md +161 -0
  330. package/squads/squad-content/knowledge-base/platform-algorithm-intelligence.md +86 -1
  331. package/squads/squad-content/knowledge-base/signal-intelligence-v2.md +234 -0
  332. package/squads/squad-content/knowledge-base/social-algorithms-master-reference.md +1007 -0
  333. package/squads/squad-content/knowledge-base/task-ownership-map.md +235 -0
  334. package/squads/squad-content/knowledge-base/video-audio-content-playbook.md +218 -0
  335. package/squads/squad-content/squad.yaml +187 -27
  336. package/squads/squad-copy/knowledge-base/ai-copy-human-loop-canon.md +235 -0
  337. package/squads/squad-copy/knowledge-base/ai-copy-production.md +254 -0
  338. package/squads/squad-copy/knowledge-base/brazilian-copywriting-context.md +242 -0
  339. package/squads/squad-copy/knowledge-base/email-copywriting-system.md +299 -0
  340. package/squads/squad-copy/knowledge-base/landing-page-copy-architecture.md +267 -0
  341. package/squads/squad-copy/knowledge-base/power-words-catalog.md +205 -0
  342. package/squads/squad-copy/knowledge-base/seo-copywriting.md +255 -0
  343. package/squads/squad-copy/knowledge-base/video-script-copywriting.md +239 -0
  344. package/squads/squad-copy/squad.yaml +19 -4
  345. package/squads/squad-council/knowledge-base/brand-strategy-models.md +193 -0
  346. package/squads/squad-council/knowledge-base/growth-strategy-models.md +267 -0
  347. package/squads/squad-council/knowledge-base/innovation-disruption-frameworks.md +193 -0
  348. package/squads/squad-council/knowledge-base/market-analysis-frameworks.md +240 -0
  349. package/squads/squad-council/knowledge-base/organizational-leadership-models.md +212 -0
  350. package/squads/squad-council/knowledge-base/sales-strategy-models.md +215 -0
  351. package/squads/squad-courses/knowledge-base/course-launch-strategy.md +251 -0
  352. package/squads/squad-courses/knowledge-base/domain-advocacia-curriculum.md +385 -0
  353. package/squads/squad-courses/knowledge-base/domain-contabilidade-curriculum.md +266 -0
  354. package/squads/squad-courses/knowledge-base/platform-comparison.md +68 -0
  355. package/squads/squad-courses/knowledge-base/video-production-guide.md +70 -0
  356. package/squads/squad-cybersecurity/knowledge-base/cloud-security-reference.md +363 -0
  357. package/squads/squad-cybersecurity/knowledge-base/compliance-frameworks.md +273 -0
  358. package/squads/squad-cybersecurity/knowledge-base/database-security.md +438 -0
  359. package/squads/squad-cybersecurity/knowledge-base/incident-response-playbook.md +420 -0
  360. package/squads/squad-cybersecurity/knowledge-base/network-security-reference.md +477 -0
  361. package/squads/squad-cybersecurity/knowledge-base/penetration-testing-methodology.md +350 -0
  362. package/squads/squad-cybersecurity/knowledge-base/vulnerability-management.md +349 -0
  363. package/squads/squad-design/knowledge-base/brazilian-design-context.md +223 -0
  364. package/squads/squad-design/knowledge-base/component-api-patterns.md +208 -4
  365. package/squads/squad-design/knowledge-base/cross-surface-token-canon.md +209 -0
  366. package/squads/squad-design/knowledge-base/design-system-master-reference.md +1302 -0
  367. package/squads/squad-design/knowledge-base/design-systems-frameworks.md +91 -1
  368. package/squads/squad-design/knowledge-base/responsive-modern-css.md +96 -4
  369. package/squads/squad-design/knowledge-base/wcag-aria-reference.md +117 -5
  370. package/squads/squad-design/knowledge-base/web-performance-reference.md +127 -4
  371. package/squads/squad-design/squad.yaml +19 -4
  372. package/squads/squad-finance/knowledge-base/brazilian-taxation.md +263 -0
  373. package/squads/squad-finance/knowledge-base/contabilidade-master-reference.md +998 -0
  374. package/squads/squad-finance/knowledge-base/finance-master-reference.md +946 -0
  375. package/squads/squad-finance/knowledge-base/financial-reporting-analysis.md +316 -0
  376. package/squads/squad-finance/knowledge-base/fintech-brazilian-context.md +242 -0
  377. package/squads/squad-finance/knowledge-base/fpa-planning-frameworks.md +286 -0
  378. package/squads/squad-finance/knowledge-base/ma-and-transactions.md +285 -0
  379. package/squads/squad-finance/knowledge-base/risk-management.md +233 -0
  380. package/squads/squad-finance/knowledge-base/startups-venture-capital.md +337 -0
  381. package/squads/squad-growth/knowledge-base/ai-growth-playbook.md +216 -0
  382. package/squads/squad-growth/knowledge-base/attribution-models.md +78 -0
  383. package/squads/squad-growth/knowledge-base/brazilian-growth-context.md +208 -0
  384. package/squads/squad-growth/knowledge-base/community-led-growth.md +175 -0
  385. package/squads/squad-growth/knowledge-base/content-marketing-flywheel.md +190 -0
  386. package/squads/squad-growth/knowledge-base/email-lifecycle-framework.md +192 -0
  387. package/squads/squad-growth/knowledge-base/growth-frameworks-catalog.md +82 -0
  388. package/squads/squad-growth/knowledge-base/growth-master-reference.md +1168 -0
  389. package/squads/squad-growth/knowledge-base/routing-catalog.md +53 -11
  390. package/squads/squad-paidmedia/knowledge-base/audiences-segmentation-deep.md +285 -0
  391. package/squads/squad-paidmedia/knowledge-base/creative-strategy-deep.md +294 -0
  392. package/squads/squad-paidmedia/knowledge-base/google-ads-account-architecture.md +87 -0
  393. package/squads/squad-paidmedia/knowledge-base/meta-ads-campaign-architecture.md +76 -0
  394. package/squads/squad-paidmedia/knowledge-base/paid-media-metrics-reference.md +117 -0
  395. package/squads/squad-paidmedia/knowledge-base/paid-traffic-master-reference.md +1308 -0
  396. package/squads/squad-paidmedia/knowledge-base/routing-catalog.md +95 -18
  397. package/squads/squad-paidmedia/knowledge-base/traffic-masters-frameworks.md +71 -0
  398. package/squads/squad-product/knowledge-base/brazilian-product-context.md +284 -0
  399. package/squads/squad-product/knowledge-base/discovery-methodology-playbook.md +141 -0
  400. package/squads/squad-product/knowledge-base/pm-frameworks-reference.md +125 -9
  401. package/squads/squad-product/knowledge-base/product-analytics-formulas.md +72 -0
  402. package/squads/squad-product/knowledge-base/product-led-growth-reference.md +155 -13
  403. package/squads/squad-product/knowledge-base/product-market-fit-framework.md +222 -0
  404. package/squads/squad-product/knowledge-base/routing-catalog.md +32 -0
  405. package/squads/squad-research/knowledge-base/agentic-second-brain-reference.md +591 -0
  406. package/squads/squad-research/knowledge-base/ai-augmented-research.md +212 -0
  407. package/squads/squad-research/knowledge-base/brazilian-market-research-sources.md +197 -0
  408. package/squads/squad-research/knowledge-base/community-platforms-reference.md +786 -0
  409. package/squads/squad-research/knowledge-base/community-research-methods.md +194 -0
  410. package/squads/squad-research/knowledge-base/mixed-methods-research-design.md +168 -0
  411. package/squads/squad-research/knowledge-base/network-effects-analysis.md +192 -0
  412. package/squads/squad-research/knowledge-base/qualitative-research-deep-methods.md +202 -0
  413. package/squads/squad-research/knowledge-base/quantitative-research-methods.md +208 -0
  414. package/squads/squad-research/knowledge-base/research-frameworks-encyclopedia.md +40 -0
  415. package/squads/squad-research/knowledge-base/research-synthesis-frameworks.md +223 -0
  416. package/squads/squad-storytelling/knowledge-base/brand-mythology-framework.md +236 -0
  417. package/squads/squad-storytelling/knowledge-base/brazilian-storytelling-context.md +237 -0
  418. package/squads/squad-storytelling/knowledge-base/data-storytelling.md +232 -0
  419. package/squads/squad-storytelling/knowledge-base/improv-storytelling.md +226 -0
  420. package/squads/squad-storytelling/knowledge-base/persuasion-narrative-techniques.md +269 -0
  421. package/squads/squad-storytelling/knowledge-base/social-movement-narratives.md +191 -0
  422. package/squads/squad-storytelling/knowledge-base/video-storytelling.md +252 -0
  423. package/.sinapse-ai/core/registry/service-registry.json +0 -6346
  424. package/.sinapse-ai/data/registry-update-log.jsonl +0 -1307
  425. package/.sinapse-ai/manifests/agents.csv +0 -29
  426. package/.sinapse-ai/manifests/tasks.csv +0 -204
  427. package/.sinapse-ai/manifests/workers.csv +0 -196
  428. package/squads/claude-code-mastery/data/swarm-orchestration-patterns.yaml +0 -378
  429. package/squads/squad-animations/knowledge-base/framer-motion-complete-reference.md +0 -710
  430. package/squads/squad-animations/knowledge-base/web-animations-api-view-transitions.md +0 -478
  431. package/squads/squad-growth/tasks/calculate-sample-size.md +0 -121
  432. package/squads/squad-paidmedia/tasks/calculate-sample-size.md +0 -57
@@ -0,0 +1,946 @@
1
+ # Finance Master Reference
2
+
3
+ > **Source:** MS-013 Finance Research (2026-04-07)
4
+ > **Scope:** Corporate Finance, Valuation, Cash Flow, Capital Budgeting, Capital Structure, Risk Management, FP&A, M&A, FinTech, Pricing, Financial Reporting, Tributacao, Startups & VC
5
+ > **Context:** Brazilian market + international best practices
6
+
7
+ ---
8
+
9
+ ## 1. Corporate Finance Fundamentals
10
+
11
+ ### 1.1 Three Core Decisions
12
+
13
+ ```
14
+ OBJECTIVE: Maximize Firm Value
15
+ |
16
+ +----------------+----------------+
17
+ v v v
18
+ Investment Financing Distribution
19
+ (CAPEX) (Capital (Dividends/
20
+ Structure) Buybacks)
21
+
22
+ NPV, IRR, PI WACC, D/E, Payout Ratio,
23
+ Payback, ROIC Modigliani-Miller Gordon Model,
24
+ Real Options Pecking Order Signaling Theory
25
+ ```
26
+
27
+ ### 1.2 Key Metrics
28
+
29
+ | Metric | Formula | Purpose |
30
+ |--------|---------|---------|
31
+ | ROIC | NOPAT / Capital Invested | Return on invested capital |
32
+ | WACC | (E/V x Ke) + (D/V x Kd x (1-T)) | Weighted average cost of capital |
33
+ | EVA | NOPAT - (Capital Invested x WACC) | Economic value creation |
34
+ | EBITDA | Operating Profit + D&A | Cash flow proxy |
35
+ | FCF | EBITDA - CAPEX - delta WC - Taxes | Free cash for stakeholders |
36
+ | ROE | Net Income / Equity | Return to shareholders |
37
+ | ROA | Net Income / Total Assets | Asset efficiency |
38
+ | Net Debt/EBITDA | (Gross Debt - Cash) / EBITDA | Leverage capacity |
39
+ | Current Ratio | Current Assets / Current Liabilities | Short-term liquidity |
40
+ | Margin (Net) | Net Income / Revenue | Final profitability |
41
+
42
+ ### 1.3 DuPont Analysis
43
+
44
+ **3-factor:**
45
+ ```
46
+ ROE = Net Margin x Asset Turnover x Financial Leverage
47
+ = (NI/Revenue) x (Revenue/Assets) x (Assets/Equity)
48
+ ```
49
+
50
+ **5-factor (extended):**
51
+ ```
52
+ ROE = Tax Burden x Interest Burden x EBIT Margin x Asset Turnover x Equity Multiplier
53
+ = (NI/EBT) x (EBT/EBIT) x (EBIT/Revenue) x (Revenue/Assets) x (Assets/Equity)
54
+ ```
55
+
56
+ ### 1.4 EVA (Economic Value Added)
57
+
58
+ ```
59
+ EVA = NOPAT - (Capital Invested x WACC)
60
+
61
+ NOPAT = EBIT x (1 - Tax Rate)
62
+ Capital Invested = Equity + Debt - Cash
63
+
64
+ EVA > 0 -> creating value
65
+ EVA < 0 -> destroying value
66
+ ```
67
+
68
+ ### 1.5 Brazilian Context
69
+
70
+ - Selic: 14.75% a.a. (Mar/2026, first cut in ~2 years; projected 12.25-12.50% year-end 2026)
71
+ - Tax burden: ~33% of GDP, 90+ tributes
72
+ - B3: largest exchange in Latin America; R$517.3B in equities traded (2025)
73
+ - BRL: one of the most volatile emerging market currencies
74
+ - Tax Reform 2026-2033: CBS/IBS transition impacts all financial decisions
75
+
76
+ ### 1.6 Regulators
77
+
78
+ | Entity | Role |
79
+ |--------|------|
80
+ | BACEN (BCB) | Monetary policy, banking regulation, PIX |
81
+ | CVM | Securities market regulation |
82
+ | B3 | Exchange, derivatives, clearing |
83
+ | CMN | Top normative body |
84
+ | SUSEP | Insurance, open pension funds |
85
+ | ANBIMA | Self-regulation, fund classification |
86
+ | Receita Federal | Federal tax administration, SPED |
87
+ | Tesouro Nacional | Government debt, LTN/NTN-B/NTN-F/LFT |
88
+
89
+ ---
90
+
91
+ ## 2. Valuation & Financial Modeling
92
+
93
+ ### 2.1 Approaches
94
+
95
+ 1. **DCF** -- Present value of future cash flows (most fundamentally correct)
96
+ 2. **Relative Valuation (Multiples)** -- Value relative to comparable companies
97
+ 3. **Contingent Claims (Real Options)** -- Value of flexibility
98
+ 4. **Asset-Based** -- Net asset value (liquidation or replacement)
99
+
100
+ ### 2.2 DCF Formula
101
+
102
+ ```
103
+ Value = SUM(FCF_t / (1+WACC)^t) + Terminal Value / (1+WACC)^n
104
+
105
+ Terminal Value = FCF_(n+1) / (WACC - g) [Gordon Growth]
106
+ ```
107
+
108
+ **10-Step DCF:**
109
+ 1. Project revenues (top-down or bottom-up)
110
+ 2. Project costs and margins
111
+ 3. Calculate EBIT and NOPAT
112
+ 4. Calculate Free Cash Flow = NOPAT + D&A - CAPEX - delta WC
113
+ 5. Estimate WACC
114
+ 6. Calculate Terminal Value (Gordon Growth or Exit Multiple)
115
+ 7. Discount to present value
116
+ 8. Adjust: subtract net debt, add non-operating assets
117
+ 9. Equity Value = Firm Value - Net Debt
118
+ 10. Sensitivity analysis (WACC +/-1%, growth +/-1%)
119
+
120
+ ### 2.3 WACC
121
+
122
+ ```
123
+ WACC = (E/V) x Ke + (D/V) x Kd x (1 - T)
124
+
125
+ E = Market value of equity
126
+ D = Market value of debt
127
+ V = E + D
128
+ Ke = Cost of equity (via CAPM)
129
+ Kd = Effective cost of debt
130
+ T = Marginal tax rate
131
+ ```
132
+
133
+ ### 2.4 CAPM
134
+
135
+ ```
136
+ Ke = Rf + Beta x (Rm - Rf) + CRP
137
+
138
+ Rf = Risk-free rate (US 10Y Treasury or NTN-B in Brazil)
139
+ Beta = Systematic risk sensitivity
140
+ Rm - Rf = Equity Risk Premium (~5% US, ~8-9% EM per Damodaran)
141
+ CRP = Country Risk Premium (EMBI+ spread for Brazil)
142
+ ```
143
+
144
+ **Brazil specifics:**
145
+ - Commonly use US Risk-Free + Country Risk Premium
146
+ - Alternative: NTN-B as local risk-free
147
+ - Beta calculated against Ibovespa or adjusted for global exposure
148
+
149
+ ### 2.5 Valuation Multiples
150
+
151
+ | Multiple | Formula | When to Use |
152
+ |----------|---------|-------------|
153
+ | P/E | Price / EPS | Profitable, comparable companies |
154
+ | EV/EBITDA | Enterprise Value / EBITDA | Most versatile, capital-structure neutral |
155
+ | EV/Revenue | Enterprise Value / Revenue | Pre-profit growth companies |
156
+ | P/B | Price / Book Value | Banks, insurers, asset-heavy |
157
+ | P/FCF | Price / Free Cash Flow | Mature cash generators |
158
+
159
+ **Enterprise Value:**
160
+ ```
161
+ EV = Market Cap + Gross Debt - Cash + Minority Interest + Preferred Stock
162
+ ```
163
+
164
+ ### 2.6 Real Options
165
+
166
+ | Type | Financial Analog | Example |
167
+ |------|-----------------|---------|
168
+ | Defer | American call | Wait for clarity before building plant |
169
+ | Expand | Call on underlying | Expand capacity if demand exceeds |
170
+ | Contract | Put on underlying | Reduce operations if market deteriorates |
171
+ | Abandon | American put | Abandon project and sell assets |
172
+ | Switch | Portfolio of options | Alternate between inputs or products |
173
+ | Stage | Compound option | Invest in phases, deciding at each stage |
174
+
175
+ ### 2.7 Financial Model Best Practices (FAST Standard)
176
+
177
+ 1. **Assumptions Sheet** -- all inputs in one place (blue font)
178
+ 2. **Income Statement** -- projected P&L
179
+ 3. **Balance Sheet** -- projected
180
+ 4. **Cash Flow Statement** -- projected
181
+ 5. **DCF / Valuation** -- assessment
182
+ 6. **Sensitivity / Scenarios** -- Base / Bull / Bear
183
+ 7. **Output / Summary** -- executive dashboard
184
+
185
+ Rules: one formula per row, left-to-right flow (history -> projections), no hardcoded numbers in formulas, integrity checks (Assets = Liabilities + Equity).
186
+
187
+ ---
188
+
189
+ ## 3. Cash Flow Management
190
+
191
+ ### 3.1 Cash Flow Types
192
+
193
+ | Type | Content | Healthy Sign |
194
+ |------|---------|-------------|
195
+ | FCO (Operating) | Client receipts, supplier payments, salaries, taxes | Must be positive |
196
+ | FCI (Investing) | CAPEX, acquisitions, asset sales | Typically negative in growth |
197
+ | FCF (Financing) | Loans, equity, dividends, amortization | Source or use |
198
+
199
+ ### 3.2 Free Cash Flow
200
+
201
+ **FCFF (to Firm):**
202
+ ```
203
+ FCFF = EBIT x (1-T) + D&A - CAPEX - delta Working Capital
204
+ ```
205
+
206
+ **FCFE (to Equity):**
207
+ ```
208
+ FCFE = Net Income + D&A - CAPEX - delta WC - Debt Amortization + New Debt
209
+ ```
210
+
211
+ ### 3.3 Working Capital & Cash Conversion Cycle
212
+
213
+ ```
214
+ CCC = DSO + DIO - DPO
215
+
216
+ DSO = Accounts Receivable / (Revenue/365)
217
+ DIO = Inventory / (COGS/365)
218
+ DPO = Accounts Payable / (COGS/365)
219
+ ```
220
+
221
+ **Optimization levers:**
222
+
223
+ | Lever | Strategy | Impact |
224
+ |-------|----------|--------|
225
+ | Reduce DSO | Tighter credit policy, early payment discounts | Reduces CCC |
226
+ | Reduce DIO | JIT, demand forecasting, liquidate slow stock | Reduces CCC |
227
+ | Increase DPO | Negotiate longer terms, supply chain finance | Reduces CCC |
228
+
229
+ ### 3.4 Cash Forecasting Methods
230
+
231
+ - **Direct (13-week rolling):** project specific receipts/payments weekly. High precision, short-term.
232
+ - **Indirect (12-24 months):** start from projected profit, adjust non-cash items. Medium-term planning.
233
+
234
+ ### 3.5 Brazilian Treasury Instruments
235
+
236
+ | Instrument | Use |
237
+ |------------|-----|
238
+ | CDB | Invest excess cash |
239
+ | Compromissadas | Daily liquidity for treasury |
240
+ | Fundos DI | Short-term cash |
241
+ | Receivables Anticipation | Advance operating cash |
242
+ | Factoring / FIDC | Alternative to bank anticipation |
243
+ | Supply Chain Finance | Extend DPO without harming suppliers |
244
+ | Conta Garantida | Cover cash gaps |
245
+
246
+ ---
247
+
248
+ ## 4. Capital Budgeting
249
+
250
+ ### 4.1 Project Evaluation Metrics
251
+
252
+ | Metric | Formula | Decision Rule | Limitations |
253
+ |--------|---------|--------------|-------------|
254
+ | NPV | SUM(FCF_t/(1+r)^t) - Investment | NPV > 0 -> Accept | Depends on discount rate |
255
+ | IRR | Rate where NPV = 0 | IRR > WACC -> Accept | Multiple IRRs possible |
256
+ | Payback | Time to recover investment | Payback < threshold | Ignores post-payback flows |
257
+ | Discounted Payback | Time to recover (discounted) | Similar | Still ignores post-payback |
258
+ | PI | PV of FCFs / Investment | PI > 1 -> Accept | Can conflict with NPV |
259
+ | MIRR | Modified IRR with realistic reinvestment | MIRR > WACC | Complex assumptions |
260
+ | ROIC | NOPAT / Capital Invested | ROIC > WACC -> Creates value | Point-in-time metric |
261
+
262
+ **NPV is the superior method** -- measures absolute value creation, no multiple-solution problems, additive across portfolio.
263
+
264
+ ### 4.2 Analysis Techniques
265
+
266
+ | Technique | Description | Use Case |
267
+ |-----------|-------------|----------|
268
+ | Sensitivity | Vary one assumption at a time | Identify critical variables |
269
+ | Scenarios | Vary multiple assumptions (Base/Bull/Bear) | Evaluate outcome ranges |
270
+ | Monte Carlo | Simulation with probability distributions | Complex projects, high uncertainty |
271
+ | Break-even | Find point where NPV = 0 | Define minimum thresholds |
272
+ | Tornado Diagram | Visual sensitivity ranking | Stakeholder communication |
273
+
274
+ ### 4.3 Monte Carlo Steps
275
+
276
+ 1. Identify key variables (revenue, costs, growth rate, WACC)
277
+ 2. Define probability distributions (normal, triangular, uniform)
278
+ 3. Generate N simulations (typically 10,000+)
279
+ 4. Calculate NPV/IRR for each
280
+ 5. Analyze distribution (mean, std dev, percentiles)
281
+ 6. Calculate P(NPV < 0)
282
+
283
+ ---
284
+
285
+ ## 5. Capital Structure & Funding
286
+
287
+ ### 5.1 Modigliani-Miller Theorem
288
+
289
+ **Proposition I (no taxes):** Firm value is independent of capital structure.
290
+ ```
291
+ V_levered = V_unlevered (in perfect markets)
292
+ ```
293
+
294
+ **With taxes (real world):**
295
+ ```
296
+ V_levered = V_unlevered + T x D (tax shield of debt)
297
+ ```
298
+
299
+ Optimal point: marginal benefit of tax shield = marginal cost of financial distress.
300
+
301
+ ### 5.2 Theories
302
+
303
+ | Theory | Proposition |
304
+ |--------|------------|
305
+ | Trade-Off (1973) | Optimal D/E balances tax shield vs. distress costs |
306
+ | Pecking Order (Myers 1984) | Firms prefer internal funds, then debt, then equity |
307
+ | Market Timing (Baker & Wurgler 2002) | Firms issue equity when overvalued |
308
+
309
+ ### 5.3 Funding Sources
310
+
311
+ **Equity:**
312
+
313
+ | Source | Cost | When |
314
+ |--------|------|------|
315
+ | Retained Earnings | Ke (opportunity) | Always first (Pecking Order) |
316
+ | IPO | 15-25% of proceeds | Mature companies |
317
+ | Follow-on | 3-7% | Listed needing additional capital |
318
+ | Private Equity | IRR target 20-30% | Mature unlisted, turnaround |
319
+ | Venture Capital | IRR target 30-50% | Growth startups |
320
+
321
+ **Debt (Brazil):**
322
+
323
+ | Source | Typical Cost | When |
324
+ |--------|-------------|------|
325
+ | Debentures | CDI + 1-5% p.a. | Large companies with rating |
326
+ | CRI/CRA | CDI + 0.5-3% (IR exempt PF) | Real estate/agro backing |
327
+ | BNDES | TLP + spread | Investment projects |
328
+ | Working Capital Lines | CDI + 2-8% | Short-term needs |
329
+ | International Bonds | UST + 2-6% | Large companies with external access |
330
+ | Nota Comercial | CDI + 0.5-3% | Short-term, rated companies |
331
+
332
+ ### 5.4 Leverage Metrics
333
+
334
+ | Metric | Formula | Threshold |
335
+ |--------|---------|-----------|
336
+ | Net Debt/EBITDA | (Gross Debt - Cash) / EBITDA | < 2.5x (investment grade) |
337
+ | D/E | Total Debt / Equity | Sector-dependent |
338
+ | Interest Coverage | EBIT / Interest Expense | > 3x (healthy) |
339
+ | DSCR | Operating CF / Debt Service | > 1.2x (covenants) |
340
+
341
+ ### 5.5 Brazil Credit Rating (2026)
342
+
343
+ | Agency | Rating | Notes |
344
+ |--------|--------|-------|
345
+ | S&P | BB (stable) | Speculative, 2 notches below IG |
346
+ | Moody's | Ba1 (stable) | 1 notch below IG; upgraded from Ba2 Oct/2024, outlook changed to stable May/2025 |
347
+ | Fitch | BB (stable) | Upgrade unlikely before end-2026 |
348
+
349
+ ---
350
+
351
+ ## 6. Financial Markets & Instruments
352
+
353
+ ### 6.1 Brazilian Fixed Income
354
+
355
+ | Security | Issuer | Return | Risk |
356
+ |----------|--------|--------|------|
357
+ | LFT (Tesouro Selic) | Federal Gov | Selic | Sovereign |
358
+ | LTN (Tesouro Prefixado) | Federal Gov | Fixed rate | Sovereign (market risk) |
359
+ | NTN-B (Tesouro IPCA+) | Federal Gov | IPCA + fixed | Sovereign (market risk) |
360
+ | CDB | Banks | CDI%, fixed or IPCA+ | Bank credit (FGC up to R$250k) |
361
+ | LCI/LCA | Banks | Similar to CDB, IR exempt PF | Bank credit (FGC) |
362
+ | Debentures | Companies | CDI+, IPCA+, fixed | Corporate credit |
363
+ | CRI/CRA | Securitizers | Similar, IR exempt PF | Structured credit |
364
+
365
+ ### 6.2 Variable Income
366
+
367
+ | Instrument | Description |
368
+ |------------|-------------|
369
+ | ON shares | Common stock (voting rights) |
370
+ | PN shares | Preferred (minimum dividend) |
371
+ | BDRs | Brazilian Depositary Receipts (foreign stocks in Brazil) |
372
+ | ETFs | Index funds (BOVA11, IVVB11) |
373
+ | FIIs | Real estate investment funds |
374
+
375
+ ### 6.3 Derivatives
376
+
377
+ | Instrument | Use |
378
+ |------------|-----|
379
+ | DI Future | Interest rate hedge/speculation |
380
+ | Dollar Future | FX hedge |
381
+ | Ibovespa Future | Portfolio hedge |
382
+ | Stock Options | Protection, leverage, strategies |
383
+ | Swap DI x Pre | Interest rate risk management |
384
+ | NDF | FX hedge without physical delivery |
385
+
386
+ ### 6.4 Black-Scholes Model
387
+
388
+ ```
389
+ Call = S x N(d1) - K x e^(-rT) x N(d2)
390
+ Put = K x e^(-rT) x N(-d2) - S x N(-d1)
391
+
392
+ d1 = [ln(S/K) + (r + sigma^2/2) x T] / (sigma x sqrt(T))
393
+ d2 = d1 - sigma x sqrt(T)
394
+ ```
395
+
396
+ **Greeks:**
397
+
398
+ | Greek | Measures |
399
+ |-------|----------|
400
+ | Delta | Price sensitivity to underlying |
401
+ | Gamma | Rate of change of delta |
402
+ | Theta | Time decay |
403
+ | Vega | Volatility sensitivity |
404
+ | Rho | Interest rate sensitivity |
405
+
406
+ ---
407
+
408
+ ## 7. Risk Management
409
+
410
+ ### 7.1 Risk Categories
411
+
412
+ | Type | Description |
413
+ |------|-------------|
414
+ | Market | Adverse price movements (rates, FX, equity, commodities) |
415
+ | Credit | Counterparty default |
416
+ | Liquidity | Inability to meet obligations or sell assets |
417
+ | Operational | Process, people, systems, or external event failures |
418
+ | Model | Incorrect or miscalibrated models |
419
+ | Regulatory | Changes in regulation |
420
+ | Reputational | Brand/image damage |
421
+
422
+ ### 7.2 Value at Risk (VaR)
423
+
424
+ ```
425
+ VaR = Maximum expected loss in a time horizon, at a given confidence level
426
+
427
+ Example: VaR(95%, 1 day) = R$1M
428
+ -> 95% confidence that 1-day loss won't exceed R$1M
429
+ ```
430
+
431
+ | Method | Advantage | Disadvantage |
432
+ |--------|-----------|-------------|
433
+ | Parametric | Fast, simple | Underestimates fat tails |
434
+ | Historical Simulation | No distribution assumption | Limited to observed history |
435
+ | Monte Carlo | Flexible, captures non-linearities | Computationally intensive |
436
+
437
+ **Limitations:** Does not say HOW MUCH beyond VaR (use CVaR/Expected Shortfall). Does not capture Black Swans well.
438
+
439
+ ### 7.3 Hedging Instruments
440
+
441
+ | Risk | Hedge Instrument | Strategy |
442
+ |------|-----------------|----------|
443
+ | FX | NDF, dollar future, FX swap | Lock future exchange rate |
444
+ | Interest Rate | Swap DI x Pre, DI future | Convert floating to fixed |
445
+ | Commodities | Futures on B3/CME | Lock buy/sell price |
446
+ | Credit | CDS | Insurance against default |
447
+ | Inflation | NTN-B, swap IPCA x Pre | Protect against above-expected inflation |
448
+
449
+ ### 7.4 Basel Framework
450
+
451
+ | Pillar | Focus |
452
+ |--------|-------|
453
+ | Pillar 1 | Minimum capital: credit + market + operational risk |
454
+ | Pillar 2 | Supervisory review: ICAAP, stress testing |
455
+ | Pillar 3 | Market discipline: public disclosure |
456
+
457
+ **Basel III minimums:** CET1 >= 4.5%, Tier 1 >= 6%, Total >= 8% + buffers (conservation 2.5%, countercyclical 0-2.5%, systemic 1-3.5%).
458
+
459
+ ---
460
+
461
+ ## 8. FP&A (Financial Planning & Analysis)
462
+
463
+ ### 8.1 Planning Framework
464
+
465
+ ```
466
+ Strategic Plan (3-5 years)
467
+ |
468
+ v
469
+ Annual Operating Plan (AOP)
470
+ |
471
+ v
472
+ Rolling Forecast (12-18 months, monthly updates)
473
+ |
474
+ v
475
+ Variance Analysis (Budget vs. Actual)
476
+ |
477
+ v
478
+ Reforecast / Adjustments
479
+ ```
480
+
481
+ ### 8.2 Budget Types
482
+
483
+ | Type | Description | Best For |
484
+ |------|-------------|----------|
485
+ | Traditional | Historical base + incremental | Stable environments |
486
+ | ZBB (Zero-Based) | Every expense justified from zero | Restructurings, cost cuts |
487
+ | Beyond Budgeting | No fixed budget, relative targets | Agile, decentralized orgs |
488
+ | Rolling Forecast | Continuous 12-18 month projection | Volatile environments |
489
+ | Activity-Based | Based on activities and cost drivers | Complex operations |
490
+
491
+ ### 8.3 ZBB (Zero-Based Budgeting)
492
+
493
+ Popularized by Peter Pyhrr (Texas Instruments, 1969). Adopted by 3G Capital (Lemann, Telles, Sicupira) at AmBev, Burger King, Kraft Heinz.
494
+
495
+ 1. **Decision packages** -- each activity has cost, benefit, alternatives
496
+ 2. **Prioritization** -- packages ranked by benefit/cost
497
+ 3. **Cut-off line** -- above: approved; below: cut
498
+ 4. **Zero-based thinking** -- "If we didn't have this expense, would we create it today?"
499
+
500
+ ### 8.4 Beyond Budgeting (12 Principles)
501
+
502
+ **6 Leadership:** Purpose, Values, Transparency, Organization (autonomous teams), Autonomy, Customer connection.
503
+
504
+ **6 Management:** Rhythm (dynamic not annual), Relative targets, Continuous plans, On-demand resources, Holistic evaluation, Shared rewards.
505
+
506
+ ### 8.5 KPIs by Area
507
+
508
+ | Area | Key KPIs |
509
+ |------|----------|
510
+ | Revenue | Revenue Growth, MRR/ARR, ARPU, Churn, LTV |
511
+ | Profitability | Gross Margin, EBITDA Margin, Net Margin, ROE, ROIC |
512
+ | Liquidity | Current Ratio, Quick Ratio, Cash Burn Rate, Runway |
513
+ | Efficiency | CAC, LTV/CAC, Rule of 40, Revenue per Employee |
514
+ | Leverage | Net Debt/EBITDA, Interest Coverage, DSCR |
515
+ | Working Capital | DSO, DIO, DPO, CCC |
516
+
517
+ ---
518
+
519
+ ## 9. M&A (Mergers & Acquisitions)
520
+
521
+ ### 9.1 Transaction Types
522
+
523
+ | Type | Description |
524
+ |------|-------------|
525
+ | Merger | Two companies combine into new entity |
526
+ | Acquisition | One company buys another |
527
+ | LBO | Acquisition primarily financed by debt |
528
+ | MBO | Management buys the company |
529
+ | Spin-off | Division separated as independent entity |
530
+ | Acqui-hire | Acquisition to capture talent |
531
+
532
+ ### 9.2 M&A Process
533
+
534
+ ```
535
+ 1. Strategy -> Define rationale (synergies, market, tech)
536
+ 2. Screening -> Identify and filter targets
537
+ 3. Approach -> Contact (NDA, teaser, CIM)
538
+ 4. Due Diligence-> Deep analysis (financial, legal, tax, operational)
539
+ 5. Valuation -> Fair value (DCF, multiples, precedents)
540
+ 6. Negotiation -> Price, payment form, earn-outs, warranties
541
+ 7. Structuring -> Legal, tax, regulatory (CADE in Brazil)
542
+ 8. Closing -> Signing, conditions precedent, payment
543
+ 9. PMI -> Post-Merger Integration (most critical phase)
544
+ ```
545
+
546
+ ### 9.3 Synergies
547
+
548
+ | Type | Reliability |
549
+ |------|-------------|
550
+ | Cost Synergies | Most reliable -- eliminate redundancies, scale |
551
+ | Revenue Synergies | Less reliable -- cross-selling, new markets |
552
+ | Financial Synergies | Moderate -- lower cost of capital, tax benefits |
553
+
554
+ **Rule of thumb:** Sophisticated investors apply 30-50% haircut to projected synergies. 60-70% of acquisitions destroy value for the acquirer (McKinsey, BCG).
555
+
556
+ ### 9.4 CADE (Brazilian Antitrust)
557
+
558
+ Mandatory notification if: one group revenue >= R$750M/year AND other >= R$75M/year.
559
+ Decisions: unconditional approval, approval with remedies, rejection.
560
+
561
+ ### 9.5 Valuation Methods in M&A
562
+
563
+ | Method | Base |
564
+ |--------|------|
565
+ | DCF | Projected cash flow |
566
+ | Trading Multiples | EV/EBITDA, P/E of comparable listed companies |
567
+ | Transaction Multiples | Multiples paid in recent similar deals |
568
+ | LBO Analysis | IRR target for PE sponsor |
569
+ | Accretion/Dilution | EPS impact on acquirer |
570
+ | Sum of Parts | DCF or multiples per business unit |
571
+
572
+ ---
573
+
574
+ ## 10. FinTech & Financial Innovation
575
+
576
+ ### 10.1 Brazilian FinTech Landscape
577
+
578
+ - 1,706 fintechs in operation (Distrito, 2025)
579
+ - Credit by fintechs: R$35.5B in 2024 (+68% YoY)
580
+ - 9 of 12 latam unicorn candidates are Brazilian (Omie, Tractian, Mottu, Flash, Celcoin)
581
+
582
+ ### 10.2 PIX
583
+
584
+ - 890M+ registered keys (Nov/2025)
585
+ - ~6.7B transactions/month (2025); R$35.4T moved annually
586
+ - 24/7, settlement in seconds, free for individuals
587
+ - **PIX Automatico:** launched Jun/2025, mandatory since Oct/2025 for interbank debits
588
+ - **PIX NFC (Tap):** launched Feb/2025, Android via Google Pay (R$500/transaction limit)
589
+ - Record: 313M transactions in a single day (Dec/2025)
590
+
591
+ ### 10.3 Open Finance Brazil
592
+
593
+ - 62M active consents (Jan/2025, +44% YoY)
594
+ - 2.3B+ successful API calls/week -- largest Open Finance ecosystem globally
595
+ - All 4 phases implemented (products, clients, payments, investments/insurance)
596
+ - **2026:** Credit portability via Open Finance (Feb/2026 personal; Aug/2026 federal payroll)
597
+
598
+ ### 10.4 DREX (Digital Real)
599
+
600
+ - **Nov/2025 reformulation:** BCB ended original DLT pilot, removed payments capability
601
+ - **New focus:** liens/collateral (gravames) -- secure registration of assets used as guarantee
602
+ - **Next pilot (1H 2026):** BCB to define supporting technology
603
+ - **Status:** Uncertain future as payments CBDC; transformed into asset registration infrastructure
604
+
605
+ ### 10.5 FinTech Segments
606
+
607
+ | Segment | Examples (Brazil) |
608
+ |---------|-------------------|
609
+ | Payments | Nubank, PagSeguro, Stone, Mercado Pago |
610
+ | Credit | Creditas, Nexoos |
611
+ | Investments | XP, Warren, Magnetis |
612
+ | Digital Banking | Nubank, C6 Bank, Inter |
613
+ | Insurtech | Pier, Justos, Clude |
614
+ | Regtech | idwall, Celcoin |
615
+ | Embedded Finance | Zoop, Dock, Matera |
616
+
617
+ ### 10.6 AI in Finance
618
+
619
+ | Application | Maturity |
620
+ |-------------|----------|
621
+ | Credit Scoring (ML) | High |
622
+ | Fraud Detection (real-time) | High |
623
+ | Robo-Advisory | Medium-High |
624
+ | Algorithmic Trading | High (institutional) |
625
+ | NLP for Compliance | Medium |
626
+ | Risk Prediction Models | Medium-High |
627
+
628
+ ---
629
+
630
+ ## 11. Pricing Strategy & Revenue Management
631
+
632
+ ### 11.1 Pricing Frameworks
633
+
634
+ | Framework | Approach | When |
635
+ |-----------|----------|------|
636
+ | Cost-Plus | Cost + desired margin | Commodities, government contracts |
637
+ | Value-Based | Customer perceived value | Differentiated products, SaaS, luxury |
638
+ | Competitive | Alignment with competitors | Commoditized markets |
639
+ | Dynamic | Price varies by demand/context | Airlines, hotels, e-commerce |
640
+ | Freemium | Free + premium paid | SaaS, apps, platforms |
641
+ | Penetration | Low price for market share | Competitive market launch |
642
+ | Skimming | High initial, reduced over time | Innovation, cutting-edge tech |
643
+ | Subscription | Recurring monthly/annual | SaaS, streaming |
644
+ | Usage-Based | Pay per use | Cloud (AWS), APIs, telecom |
645
+
646
+ **Impact:** 1% improvement in average price increases operating profit by ~11% (McKinsey).
647
+
648
+ ### 11.2 Price Elasticity
649
+
650
+ ```
651
+ E = (delta Q / Q) / (delta P / P)
652
+
653
+ E < -1: Elastic demand (price increase reduces revenue)
654
+ E > -1: Inelastic demand (price increase raises revenue)
655
+ E = -1: Unitary (maximum revenue)
656
+ ```
657
+
658
+ ### 11.3 Revenue & Pricing Metrics
659
+
660
+ | Metric | Formula | Context |
661
+ |--------|---------|---------|
662
+ | ARPU | Revenue / Users | SaaS, telecom |
663
+ | MRR | Monthly Recurring Revenue | SaaS |
664
+ | ARR | MRR x 12 | SaaS |
665
+ | Net Revenue Retention | End MRR (same cohort) / Start MRR | > 100% = expansion |
666
+ | LTV | ARPU x Gross Margin x (1/Churn) | Customer lifetime value |
667
+ | CAC | Sales+Marketing / New Customers | Acquisition cost |
668
+ | LTV/CAC | LTV / CAC | > 3x healthy |
669
+ | CAC Payback | CAC / (ARPU x Gross Margin) | Months to recover |
670
+
671
+ ---
672
+
673
+ ## 12. Financial Reporting & Analysis
674
+
675
+ ### 12.1 Mandatory Statements (Brazil)
676
+
677
+ | Statement | Shows |
678
+ |-----------|-------|
679
+ | Balance Sheet (BP) | Financial position (snapshot) |
680
+ | Income Statement (DRE) | Period performance (movie) |
681
+ | Cash Flow Statement (DFC) | Cash movements by activity |
682
+ | Statement of Changes in Equity (DMPL) | Equity variations |
683
+ | Value Added Statement (DVA) | Wealth generated and distributed (open S/As) |
684
+ | Notes | Accounting policies and supplementary info |
685
+
686
+ ### 12.2 IFRS 18 / CPC 51 -- New Income Statement (2027)
687
+
688
+ - Mandatory categories: Operating, Investing, Financing (similar to DFC structure)
689
+ - Management Performance Measures (MPMs): non-GAAP metrics must be reconciled
690
+ - Mandatory subtotals: operating profit and profit before financing
691
+ - **Effective:** Jan 1, 2027 (CVM Res. 237/238, Dec/2025); retrospective application required
692
+
693
+ ### 12.3 Analysis Ratios
694
+
695
+ | Group | Key Ratios |
696
+ |-------|-----------|
697
+ | Liquidity | Current, Quick, Cash Ratio |
698
+ | Profitability | ROE, ROA, ROIC, Net Margin, EBITDA Margin |
699
+ | Activity | Asset Turnover, DSO, DIO, DPO, CCC |
700
+ | Leverage | D/E, Net Debt/EBITDA, Interest Coverage |
701
+ | Market | P/E, EV/EBITDA, P/B, Dividend Yield |
702
+
703
+ ### 12.4 Earnings Quality Signals
704
+
705
+ | Red Flag | What to Investigate |
706
+ |----------|-------------------|
707
+ | Revenue growing faster than cash flow | Aggressive revenue recognition |
708
+ | A/R growing faster than revenue | Questionable sales, channel stuffing |
709
+ | Frequent accounting policy changes | Earnings management |
710
+ | Recurring "non-recurring" items | Items that repeat every quarter |
711
+ | High accruals | Large gap between profit and cash generated |
712
+
713
+ **Beneish M-Score:** M-Score > -1.78 indicates high manipulation probability. Uses 8 variables (DSRI, GMI, AQI, SGI, DEPI, SGAI, TATA, LVGI).
714
+
715
+ ---
716
+
717
+ ## 13. Taxation & Tax Planning (Financial View)
718
+
719
+ ### 13.1 Brazilian Tax Regimes
720
+
721
+ | Regime | Annual Revenue | Taxation | For Whom |
722
+ |--------|---------------|----------|----------|
723
+ | MEI | Up to R$81K | Fixed monthly (~R$70) | Micro-entrepreneurs |
724
+ | Simples Nacional | Up to R$4.8M | Progressive table (4-33%) | Micro/small |
725
+ | Lucro Presumido | Up to R$78M | Presumed margin x rate | Services, commerce |
726
+ | Lucro Real | No limit (mandatory >R$78M) | Actual profit x 34% (IRPJ+CSLL) | Large companies |
727
+
728
+ ### 13.2 Key Taxes
729
+
730
+ | Tax | Base | Rate | Financial Impact |
731
+ |-----|------|------|-----------------|
732
+ | IRPJ | Profit | 15% + 10% surcharge | Direct on NI and FCF |
733
+ | CSLL | Profit | 9% (20% financials) | Direct on NI and FCF |
734
+ | PIS/COFINS | Revenue | 3.65% (cumul.) or 9.25% (non-cumul.) | Pricing and margin |
735
+ | ICMS | Goods | 7-25% (varies by state) | Logistics, location, pricing |
736
+ | ISS | Services | 2-5% (varies by city) | Service margin |
737
+ | IOF | Financial ops | Varies | Financing cost |
738
+
739
+ ### 13.3 Tax Reform 2026-2033
740
+
741
+ | New Tax | Replaces | Estimated Rate |
742
+ |---------|----------|---------------|
743
+ | CBS | PIS + COFINS (federal) | ~9.3% |
744
+ | IBS | ICMS + ISS (state/municipal) | ~18.7% |
745
+ | IS (Seletivo) | IPI (partial, harmful goods) | Variable |
746
+
747
+ **Combined estimated rate: ~28%** (one of the highest IVA rates globally; EU avg ~21%, OECD avg ~19%).
748
+
749
+ **Transition timeline:**
750
+
751
+ | Year | Event |
752
+ |------|-------|
753
+ | 2026 | Test: CBS 0.9% + IBS 0.1% on invoices (informational only, no collection) |
754
+ | 2027 | CBS effective (~8.8%). IS effective. PIS/COFINS extinguished |
755
+ | 2029-2032 | IBS gradual transition (ICMS/ISS reduced by tenths) |
756
+ | 2033 | ICMS/ISS extinguished. IBS fully effective |
757
+
758
+ **Financial impacts:**
759
+ - Two systems coexisting for 7 years (operational complexity)
760
+ - Broad non-cumulative credits (IBS more generous than current system)
761
+ - Complete repricing of products/services required
762
+ - Significant ERP/tax system investments needed
763
+ - State tax incentives (ICMS) phased out
764
+
765
+ ### 13.4 Legitimate Tax Planning Strategies
766
+
767
+ | Strategy | Application |
768
+ |----------|-------------|
769
+ | Regime choice | Simulate Simples/Presumido/Real annually |
770
+ | JCP (Interest on Equity) | IRPJ/CSLL deductible for companies with high equity on Lucro Real |
771
+ | Tax incentives | Lei de Informatica, SUDENE/SUDAM, Zona Franca de Manaus |
772
+ | Accelerated depreciation | Anticipate tax benefit on CAPEX |
773
+ | Transfer pricing | Law 14.596/2023 (arm's length, OECD-aligned) |
774
+ | Family holding | Estate and succession planning |
775
+
776
+ ---
777
+
778
+ ## 14. Startups & Venture Capital
779
+
780
+ ### 14.1 Brazilian VC Market
781
+
782
+ | Year | VC Investment | Deals | Notes |
783
+ |------|--------------|-------|-------|
784
+ | 2021 | ~US$9.4B (peak) | 700+ | Post-pandemic boom |
785
+ | 2023 | ~US$1.8B (winter) | ~228 | Cycle bottom |
786
+ | 2024 | ~US$2.3B (+17% YoY) | ~123 | Recovery with selectivity, higher ticket |
787
+ | 2025-26 | US$3-4B (est.) | Growing | Focus on AI, fintech, agtech |
788
+
789
+ ### 14.2 Funding Rounds
790
+
791
+ | Round | Typical Investment | Typical Valuation | Key Metrics |
792
+ |-------|-------------------|-------------------|-------------|
793
+ | Pre-Seed | R$200K-1M | R$1-5M | Team, problem, TAM |
794
+ | Seed | R$1-5M | R$5-20M | MVP, early traction, unit economics |
795
+ | Series A | R$10-40M | R$40-150M | PMF, revenue growth, CAC/LTV |
796
+ | Series B | R$40-150M | R$150-500M | Scale, efficiency, path to profit |
797
+ | Series C+ | R$150M+ | R$500M+ | Market dominance, proven unit economics |
798
+
799
+ ### 14.3 SaaS Startup Metrics
800
+
801
+ | Metric | Formula | Benchmark |
802
+ |--------|---------|-----------|
803
+ | MRR | Sum monthly subscriptions | >15% MoM growth (early) |
804
+ | ARR | MRR x 12 | US$1M ARR = milestone |
805
+ | Churn | Lost customers / Total | <5% monthly (SMB), <1% (Enterprise) |
806
+ | NRR | End MRR (cohort) / Start MRR | >120% excellent, >100% good |
807
+ | Gross Margin | (Revenue - COGS) / Revenue | >70% (healthy SaaS) |
808
+ | CAC Payback | CAC / (ARPA x Gross Margin) | <18 months |
809
+ | Rule of 40 | Growth% + EBITDA Margin% | >40% excellent |
810
+ | Burn Multiple | Net Burn / Net New ARR | <2x efficient |
811
+ | Runway | Cash / Monthly Burn | >18 months safe |
812
+ | Magic Number | Net New ARR / S&M (prior Q) | >0.75 efficient |
813
+
814
+ ### 14.4 Unit Economics
815
+
816
+ ```
817
+ LTV = ARPA x Gross Margin x (1 / Monthly Churn)
818
+ CAC = (Sales + Marketing Cost) / New Customers
819
+ Payback = CAC / (ARPA x Gross Margin)
820
+ LTV/CAC Target: > 3x
821
+ ```
822
+
823
+ ### 14.5 Cap Table & Dilution Example
824
+
825
+ ```
826
+ Foundation: Founders 100%
827
+ Pre-Seed: Founders 85% | Angels 15%
828
+ Seed: Founders 68% | Angels 12% | Seed VC 20%
829
+ Series A: Founders 51% | Angels 9% | Seed 15% | A 25%
830
+ Series B: Founders 38% | Angels 7% | Seed 11% | A 19% | B 25%
831
+ ```
832
+
833
+ **Common instruments:** SAFE, Convertible Note, Preferred Stock, ESOP (10-15% pool).
834
+
835
+ ### 14.6 Startup Valuation Methods
836
+
837
+ | Method | Stage | Base |
838
+ |--------|-------|------|
839
+ | Berkus | Pre-revenue | 5 qualitative factors, up to US$2M |
840
+ | Scorecard | Pre-revenue | Comparison with similar startups |
841
+ | Comparable Transactions | Seed/A | Multiples from recent similar deals |
842
+ | Revenue Multiple | Series A+ | ARR x sector multiple (5-30x for SaaS) |
843
+ | VC Method | Any | Terminal value / (1+IRR)^n |
844
+ | DCF | Growth/Late | FCF projection (high uncertainty) |
845
+
846
+ ### 14.7 Key VCs in Brazil
847
+
848
+ | VC | Focus | Notable Deals |
849
+ |----|-------|---------------|
850
+ | Kaszek | Latam early-to-growth | Nubank, Creditas, Kavak |
851
+ | Monashees | Latam early-to-growth | 99, Rappi, Nuvemshop |
852
+ | SoftBank Latam | Growth | Gympass, MadeiraMadeira |
853
+ | QED Investors | FinTech | Nubank, Loft, Creditas |
854
+ | Valor Capital | Cross-border | Gympass, CloudWalk |
855
+ | Canary | Early stage Brazil | Alice, Caju, Clara |
856
+ | Maya Capital | Early stage Brazil | Pipefy, Cora |
857
+
858
+ ---
859
+
860
+ ## 15. Historical Timeline
861
+
862
+ | Year | Milestone |
863
+ |------|-----------|
864
+ | 1202 | Fibonacci introduces present value calculation |
865
+ | 1602 | VOC -- first publicly traded company |
866
+ | 1952 | Markowitz -- Modern Portfolio Theory |
867
+ | 1958 | Modigliani-Miller -- Capital Structure Irrelevance |
868
+ | 1964 | Sharpe -- CAPM |
869
+ | 1973 | Black-Scholes -- Options pricing model |
870
+ | 1976 | Brazil Law 6.404 (Corporations Act) |
871
+ | 1994 | Plano Real -- Brazilian monetary stabilization |
872
+ | 2000 | Novo Mercado (B3) -- corporate governance |
873
+ | 2008 | Global Financial Crisis |
874
+ | 2020 | PIX launched |
875
+ | 2023 | Tax Reform approved (EC 132/2023) |
876
+ | 2025 | DREX reformulated; PIX Automatico launched; PIX NFC operational |
877
+ | 2026 | CBS/IBS test phase; Open Finance credit portability |
878
+
879
+ ---
880
+
881
+ ## 16. Reference Books (Bibles by Sub-Area)
882
+
883
+ | Sub-Area | Book | Author |
884
+ |----------|------|--------|
885
+ | Corporate Finance | Principles of Corporate Finance | Brealey, Myers & Allen |
886
+ | Valuation | Investment Valuation | Aswath Damodaran |
887
+ | Valuation (praxis) | Valuation | McKinsey (Koller, Goedhart, Wessels) |
888
+ | Investment Banking | Investment Banking | Rosenbaum & Pearl |
889
+ | Derivatives | Options, Futures, and Other Derivatives | John Hull |
890
+ | Risk Management | Value at Risk | Philippe Jorion |
891
+ | Brazilian Market | Mercado Financeiro: Produtos e Servicos | Eduardo Fortuna |
892
+ | Financial Analysis | Financial Statement Analysis & Security Valuation | Stephen Penman |
893
+ | Behavioral Finance | Thinking, Fast and Slow | Daniel Kahneman |
894
+ | Value Investing | The Intelligent Investor | Benjamin Graham |
895
+ | M&A | Mergers, Acquisitions & Restructuring | DePamphilis |
896
+ | Venture Capital | Venture Deals | Brad Feld & Jason Mendelson |
897
+ | Pricing | Strategy and Tactics of Pricing | Nagle & Muller |
898
+ | FinTech | Bank 4.0 | Brett King |
899
+ | Brazilian Finance | Financas Corporativas e Valor | Alexandre Assaf Neto |
900
+ | 3G Capital / ZBB | Sonho Grande | Cristiane Correa |
901
+ | Risk | The Black Swan | Nassim Nicholas Taleb |
902
+ | Startups | The Lean Startup | Eric Ries |
903
+
904
+ ---
905
+
906
+ ## 17. Key People
907
+
908
+ ### Academics
909
+
910
+ | Name | Contribution |
911
+ |------|-------------|
912
+ | Harry Markowitz | Modern Portfolio Theory (Nobel 1990) |
913
+ | William Sharpe | CAPM, Sharpe Ratio (Nobel 1990) |
914
+ | Modigliani & Miller | M&M Theorem (Nobel 1985/1990) |
915
+ | Black, Scholes, Merton | Options pricing (Nobel 1997) |
916
+ | Eugene Fama | Efficient Market Hypothesis (Nobel 2013) |
917
+ | Daniel Kahneman | Prospect Theory (Nobel 2002) |
918
+ | Aswath Damodaran | "Dean of Valuation" (NYU Stern) |
919
+ | Stephen Ross | APT, Risk-Neutral Pricing |
920
+
921
+ ### Practitioners
922
+
923
+ | Name | Contribution |
924
+ |------|-------------|
925
+ | Benjamin Graham | Value investing pioneer |
926
+ | Warren Buffett | Applied value investing (Berkshire) |
927
+ | George Soros | Reflexivity theory (Quantum Fund) |
928
+ | Ray Dalio | Risk parity (Bridgewater) |
929
+ | John Bogle | Index investing (Vanguard) |
930
+ | Jim Simons | Quantitative trading (Renaissance) |
931
+
932
+ ### Brazilian
933
+
934
+ | Name | Contribution |
935
+ |------|-------------|
936
+ | Jorge Paulo Lemann | 3G Capital, ZBB culture |
937
+ | David Velez | Nubank |
938
+ | Guilherme Benchimol | XP -- democratized investing |
939
+ | Roberto Campos Neto | BCB modernization, PIX, Open Finance (2019-2024) |
940
+ | Gabriel Galipolo | BCB president (2025-present), first Selic cut cycle |
941
+ | Alexandre Assaf Neto | Academic finance reference (FEA/USP) |
942
+
943
+ ---
944
+
945
+ *Finance Master Reference v1.0 -- SINAPSE squad-finance knowledge base*
946
+ *Source: MS-013 Finance Research (2026-04-07)*