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.
- package/.claude/CLAUDE.md +60 -341
- package/.claude/hooks/enforce-architecture-first.py +197 -197
- package/.claude/hooks/enforce-git-push-authority.sh +25 -4
- package/.claude/hooks/mind-clone-governance.py +193 -193
- package/.claude/hooks/read-protection.py +152 -152
- package/.claude/hooks/sql-governance.py +183 -183
- package/.claude/hooks/verify-packages.cjs +83 -0
- package/.claude/hooks/write-path-validation.py +195 -195
- package/.claude/rules/agent-authority.md +6 -0
- package/.claude/rules/agent-handoff.md +5 -0
- package/.claude/rules/cross-squad-routing.md +5 -0
- package/.claude/rules/hook-governance.md +7 -0
- package/.claude/rules/mandatory-delegation.md +24 -0
- package/.claude/rules/mcp-usage.md +3 -1
- package/.claude/rules/project-intelligence.md +63 -0
- package/.claude/rules/response-format.md +4 -0
- package/.claude/rules/safe-collaboration.md +14 -2
- package/.claude/rules/security-data-protection.md +27 -0
- package/.claude/rules/squad-awareness.md +96 -68
- package/.claude/rules/token-economy.md +148 -0
- package/.claude/rules/tool-examples.md +6 -0
- package/.claude/rules/workflow-execution.md +7 -0
- package/.codex/agents/analyst.md +342 -71
- package/.codex/agents/architect.md +533 -68
- package/.codex/agents/data-engineer.md +530 -106
- package/.codex/agents/developer.md +657 -0
- package/.codex/agents/devops.md +639 -69
- package/.codex/agents/product-lead.md +362 -0
- package/.codex/agents/project-lead.md +405 -0
- package/.codex/agents/quality-gate.md +538 -0
- package/.codex/agents/sinapse-orqx.md +9 -7
- package/.codex/agents/sprint-lead.md +315 -0
- package/.codex/agents/squad-creator.md +402 -0
- package/.codex/agents/ux-design-expert.md +523 -0
- package/.codex/delegation-matrix.json +756 -44
- package/.codex/handoff-packet.schema.json +30 -6
- package/.sinapse-ai/core/code-intel/registry-syncer.js +56 -3
- package/.sinapse-ai/core/doctor/checks/agent-memory.js +5 -1
- package/.sinapse-ai/core/doctor/checks/claude-md.js +4 -1
- package/.sinapse-ai/core/doctor/checks/code-intel.js +5 -1
- package/.sinapse-ai/core/doctor/checks/commands-count.js +4 -1
- package/.sinapse-ai/core/doctor/checks/constitution-consistency.js +4 -1
- package/.sinapse-ai/core/doctor/checks/core-config.js +4 -1
- package/.sinapse-ai/core/doctor/checks/entity-registry.js +6 -1
- package/.sinapse-ai/core/doctor/checks/git-hooks.js +5 -1
- package/.sinapse-ai/core/doctor/checks/graph-dashboard.js +4 -1
- package/.sinapse-ai/core/doctor/checks/hooks-claude-count.js +5 -1
- package/.sinapse-ai/core/doctor/checks/ide-sync.js +4 -1
- package/.sinapse-ai/core/doctor/checks/node-version.js +4 -1
- package/.sinapse-ai/core/doctor/checks/npm-packages.js +4 -1
- package/.sinapse-ai/core/doctor/checks/rules-files.js +4 -1
- package/.sinapse-ai/core/doctor/checks/settings-json.js +4 -1
- package/.sinapse-ai/core/doctor/checks/skills-count.js +4 -1
- package/.sinapse-ai/core/doctor/index.js +157 -50
- package/.sinapse-ai/core/ids/registry-updater.js +6 -1
- package/.sinapse-ai/core/logger/index.js +319 -0
- package/.sinapse-ai/core/orchestration/terminal-spawner.js +2 -2
- package/.sinapse-ai/core/telemetry/index.js +247 -0
- package/.sinapse-ai/data/entity-registry.yaml +1060 -808
- package/.sinapse-ai/development/agents/analyst.md +90 -0
- package/.sinapse-ai/development/agents/architect.md +78 -0
- package/.sinapse-ai/development/agents/data-engineer.md +38 -0
- package/.sinapse-ai/development/agents/developer.md +97 -0
- package/.sinapse-ai/development/agents/devops.md +121 -0
- package/.sinapse-ai/development/agents/product-lead.md +27 -0
- package/.sinapse-ai/development/agents/project-lead.md +28 -0
- package/.sinapse-ai/development/agents/quality-gate.md +89 -0
- package/.sinapse-ai/development/agents/sprint-lead/MEMORY.md +8 -0
- package/.sinapse-ai/development/agents/sprint-lead.md +28 -0
- package/.sinapse-ai/development/agents/squad-creator.md +58 -0
- package/.sinapse-ai/development/agents/ux-design-expert.md +28 -0
- package/.sinapse-ai/development/checklists/agent-quality-gate.md +27 -0
- package/.sinapse-ai/development/checklists/brownfield-compatibility-checklist.md +20 -0
- package/.sinapse-ai/development/checklists/code-review-checklist.md +106 -0
- package/.sinapse-ai/development/checklists/issue-triage-checklist.md +9 -0
- package/.sinapse-ai/development/checklists/memory-audit-checklist.md +16 -0
- package/.sinapse-ai/development/checklists/pr-quality-checklist.md +72 -0
- package/.sinapse-ai/development/checklists/security-deployment-checklist.md +54 -0
- package/.sinapse-ai/development/checklists/self-critique-checklist.md +19 -1
- package/.sinapse-ai/development/knowledge-base/agent-communication-protocol.md +127 -0
- package/.sinapse-ai/development/knowledge-base/database-scaling-patterns.md +374 -0
- package/.sinapse-ai/development/knowledge-base/environment-deployment-patterns.md +353 -0
- package/.sinapse-ai/development/knowledge-base/gotchas-patterns.md +224 -0
- package/.sinapse-ai/development/knowledge-base/infrastructure-decision-framework.md +221 -0
- package/.sinapse-ai/development/knowledge-base/security-pre-deploy-checklist.md +410 -0
- package/.sinapse-ai/development/knowledge-base/software-architecture-patterns.md +299 -0
- package/.sinapse-ai/development/knowledge-base/token-economy-guide.md +198 -0
- package/.sinapse-ai/development/scripts/populate-entity-registry.js +5 -1
- package/.sinapse-ai/development/skills/captcha-handler.md +82 -0
- package/.sinapse-ai/development/skills/chrome-brain.md +81 -0
- package/.sinapse-ai/development/skills/debug.md +57 -0
- package/.sinapse-ai/development/skills/deploy-readiness.md +93 -0
- package/.sinapse-ai/development/skills/fast-review.md +69 -0
- package/.sinapse-ai/development/skills/model-router.md +92 -0
- package/.sinapse-ai/development/skills/research-synthesis.md +77 -0
- package/.sinapse-ai/development/skills/security-scan.md +73 -0
- package/.sinapse-ai/development/skills/sinapse-methodology.md +175 -0
- package/.sinapse-ai/development/skills/story-fast-track.md +71 -0
- package/.sinapse-ai/development/skills/verify.md +53 -0
- package/.sinapse-ai/development/tasks/dev-develop-story.md +10 -0
- package/.sinapse-ai/development/tasks/environment-promotion-pipeline.md +582 -0
- package/.sinapse-ai/development/tasks/generate-agent-handoff.md +223 -0
- package/.sinapse-ai/development/tasks/infrastructure-assessment.md +432 -0
- package/.sinapse-ai/development/tasks/load-testing-setup.md +611 -0
- package/.sinapse-ai/development/tasks/observability-blueprint.md +562 -0
- package/.sinapse-ai/development/templates/legal/breach-notification-tmpl.md +113 -0
- package/.sinapse-ai/development/templates/legal/privacy-policy-tmpl.md +93 -0
- package/.sinapse-ai/development/templates/legal/terms-of-service-tmpl.md +85 -0
- package/.sinapse-ai/development/templates/service-template/README.md.hbs +159 -159
- package/.sinapse-ai/development/templates/service-template/__tests__/index.test.ts.hbs +238 -238
- package/.sinapse-ai/development/templates/service-template/client.ts.hbs +404 -404
- package/.sinapse-ai/development/templates/service-template/errors.ts.hbs +183 -183
- package/.sinapse-ai/development/templates/service-template/index.ts.hbs +121 -121
- package/.sinapse-ai/development/templates/service-template/package.json.hbs +88 -88
- package/.sinapse-ai/development/templates/service-template/types.ts.hbs +146 -146
- package/.sinapse-ai/development/templates/squad/agent-template.md +17 -4
- package/.sinapse-ai/development/templates/squad/checklist-template.md +13 -5
- package/.sinapse-ai/development/templates/squad/task-template.md +7 -0
- package/.sinapse-ai/development/templates/squad/workflow-template.yaml +7 -0
- package/.sinapse-ai/development/templates/squad-template/LICENSE +22 -22
- package/.sinapse-ai/development/workflows/fast-track.yaml +87 -0
- package/.sinapse-ai/development/workflows/story-development-cycle.yaml +40 -1
- package/.sinapse-ai/hooks/ids-post-commit.js +22 -0
- package/.sinapse-ai/infrastructure/contracts/compatibility/README.md +42 -0
- package/.sinapse-ai/infrastructure/contracts/compatibility/sinapse-current.yaml +35 -0
- package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/claude-free-tracked.cmd +127 -127
- package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-proxy.cmd +71 -71
- package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-usage.cmd +51 -51
- package/.sinapse-ai/infrastructure/scripts/pr-review-ai.js +16 -13
- package/.sinapse-ai/infrastructure/scripts/setup-project-infra.js +128 -0
- package/.sinapse-ai/infrastructure/scripts/test-discovery.js +8 -3
- package/.sinapse-ai/infrastructure/scripts/validate-codex-delegation.js +3 -1
- package/.sinapse-ai/infrastructure/scripts/validate-manifest-parity.js +380 -0
- package/.sinapse-ai/infrastructure/scripts/validate-parity.js +76 -25
- package/.sinapse-ai/infrastructure/templates/coderabbit.yaml.template +280 -280
- package/.sinapse-ai/infrastructure/templates/config/env.example +16 -0
- package/.sinapse-ai/infrastructure/templates/config/gitignore-additions.tmpl +59 -0
- package/.sinapse-ai/infrastructure/templates/github/CODEOWNERS.template +12 -0
- package/.sinapse-ai/infrastructure/templates/github/PULL_REQUEST_TEMPLATE.md +29 -0
- package/.sinapse-ai/infrastructure/templates/github/ci-template.yml +77 -0
- package/.sinapse-ai/infrastructure/templates/github/issue-templates/bug_report.md +34 -0
- package/.sinapse-ai/infrastructure/templates/github/issue-templates/feature_request.md +19 -0
- package/.sinapse-ai/infrastructure/templates/github-workflows/ci.yml.template +170 -170
- package/.sinapse-ai/infrastructure/templates/github-workflows/pr-automation.yml.template +331 -331
- package/.sinapse-ai/infrastructure/templates/github-workflows/release.yml.template +197 -197
- package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl +19 -19
- package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-node.tmpl +86 -86
- package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-python.tmpl +146 -146
- package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-sinapse-base.tmpl +64 -64
- package/.sinapse-ai/infrastructure/templates/sinapse-sync.yaml.template +183 -183
- package/.sinapse-ai/install-manifest.yaml +333 -162
- package/.sinapse-ai/local-config.yaml.template +65 -65
- package/.sinapse-ai/monitor/hooks/lib/__init__.py +2 -2
- package/.sinapse-ai/monitor/hooks/lib/enrich.py +59 -59
- package/.sinapse-ai/monitor/hooks/lib/send_event.py +48 -48
- package/.sinapse-ai/monitor/hooks/notification.py +30 -30
- package/.sinapse-ai/monitor/hooks/post_tool_use.py +46 -46
- package/.sinapse-ai/monitor/hooks/pre_compact.py +30 -30
- package/.sinapse-ai/monitor/hooks/pre_tool_use.py +41 -41
- package/.sinapse-ai/monitor/hooks/stop.py +30 -30
- package/.sinapse-ai/monitor/hooks/subagent_stop.py +30 -30
- package/.sinapse-ai/monitor/hooks/user_prompt_submit.py +39 -39
- package/.sinapse-ai/product/templates/adr.hbs +126 -126
- package/.sinapse-ai/product/templates/dbdr.hbs +242 -242
- package/.sinapse-ai/product/templates/epic.hbs +213 -213
- package/.sinapse-ai/product/templates/pmdr.hbs +187 -187
- package/.sinapse-ai/product/templates/prd-v2.0.hbs +217 -217
- package/.sinapse-ai/product/templates/prd.hbs +202 -202
- package/.sinapse-ai/product/templates/story-tmpl.yaml +59 -0
- package/.sinapse-ai/product/templates/story.hbs +264 -264
- package/.sinapse-ai/product/templates/task.hbs +171 -171
- package/.sinapse-ai/product/templates/tmpl-comment-on-examples.sql +159 -159
- package/.sinapse-ai/product/templates/tmpl-migration-script.sql +92 -92
- package/.sinapse-ai/product/templates/tmpl-rls-granular-policies.sql +105 -105
- package/.sinapse-ai/product/templates/tmpl-rls-kiss-policy.sql +11 -11
- package/.sinapse-ai/product/templates/tmpl-rls-roles.sql +136 -136
- package/.sinapse-ai/product/templates/tmpl-rls-simple.sql +78 -78
- package/.sinapse-ai/product/templates/tmpl-rls-tenant.sql +153 -153
- package/.sinapse-ai/product/templates/tmpl-rollback-script.sql +78 -78
- package/.sinapse-ai/product/templates/tmpl-seed-data.sql +141 -141
- package/.sinapse-ai/product/templates/tmpl-smoke-test.sql +17 -17
- package/.sinapse-ai/product/templates/tmpl-staging-copy-merge.sql +140 -140
- package/.sinapse-ai/product/templates/tmpl-stored-proc.sql +141 -141
- package/.sinapse-ai/product/templates/tmpl-trigger.sql +153 -153
- package/.sinapse-ai/product/templates/tmpl-view-materialized.sql +134 -134
- package/.sinapse-ai/product/templates/tmpl-view.sql +178 -178
- package/.sinapse-ai/scripts/diagnostics/health-dashboard/package-lock.json +427 -355
- package/LICENSE +34 -34
- package/README.en.md +167 -20
- package/README.md +190 -22
- package/bin/cli.js +510 -196
- package/bin/postinstall.js +564 -0
- package/bin/sinapse-cli +283 -283
- package/bin/sinapse-graph.js +9 -0
- package/bin/sinapse-init.js +36 -4
- package/bin/sinapse-minimal.js +20 -9
- package/bin/sinapse.js +202 -122
- package/bin/utils/deprecation-warning.js +46 -0
- package/bin/utils/pre-push-safety.js +14 -0
- package/docs/TELEMETRY.md +131 -0
- package/docs/chrome-brain-upgrade-plan.md +624 -0
- package/docs/codex-integration-process.md +22 -0
- package/docs/codex-parity-program.md +27 -0
- package/docs/framework/orqx-plan.md +1 -1
- package/docs/ide-integration.md +36 -0
- package/docs/installation/chrome-brain.md +17 -7
- package/docs/mega-upgrade-orchestration-plan.md +71 -0
- package/docs/pt/contributing.md +20 -0
- package/docs/research-synthesis-for-upgrade.md +511 -0
- package/docs/security-audit-report.md +306 -0
- package/package.json +20 -8
- package/packages/installer/src/config/configure-environment.js +19 -44
- package/packages/installer/src/detection/detect-project-type.js +181 -63
- package/packages/installer/src/installer/manifest-signature.js +32 -17
- package/packages/installer/src/wizard/i18n.js +12 -0
- package/packages/installer/src/wizard/ide-config-generator.js +8 -39
- package/packages/installer/src/wizard/index.js +119 -14
- package/packages/installer/src/wizard/questions.js +2 -3
- package/packages/installer/tests/integration/environment-configuration.test.js +7 -5
- package/packages/installer/tests/unit/detection/detect-project-type.test.js +138 -1
- package/packages/installer/tests/unit/doctor/doctor-orchestrator.test.js +3 -3
- package/packages/sinapse-install/bin/edmcp.js +0 -0
- package/packages/sinapse-install/bin/sinapse-install.js +0 -0
- package/packages/sinapse-pro-cli/bin/sinapse-pro.js +0 -0
- package/scripts/check-markdown-links.py +353 -353
- package/scripts/coverage-report-summary.js +169 -0
- package/scripts/generate-install-manifest.js +6 -2
- package/scripts/release-readiness.js +169 -0
- package/scripts/test-install-matrix-local.sh +153 -0
- package/scripts/validate-install-docs.js +394 -0
- package/scripts/validate-no-external-refs.js +376 -0
- package/scripts/validate-squad-orqx.js +302 -0
- package/scripts/validate-story-meta.js +263 -0
- package/squads/claude-code-mastery/CHANGELOG.md +1 -1
- package/squads/claude-code-mastery/README.md +2 -2
- package/squads/claude-code-mastery/knowledge-base/claude-code-internals-reference.md +927 -0
- package/squads/claude-code-mastery/squad.yaml +1 -1
- package/squads/squad-artdir/README.md +90 -0
- package/squads/squad-artdir/agents/accessibility-guardian.md +184 -0
- package/squads/squad-artdir/agents/artdir-orqx.md +145 -0
- package/squads/squad-artdir/agents/color-psychologist.md +166 -0
- package/squads/squad-artdir/agents/cro-persuasion.md +161 -0
- package/squads/squad-artdir/agents/design-system-architect.md +100 -0
- package/squads/squad-artdir/agents/ia-architect.md +169 -0
- package/squads/squad-artdir/agents/interaction-designer.md +162 -0
- package/squads/squad-artdir/agents/layout-engineer.md +163 -0
- package/squads/squad-artdir/agents/motion-architect.md +185 -0
- package/squads/squad-artdir/agents/platform-aesthetic-director.md +84 -0
- package/squads/squad-artdir/agents/premium-packaging-strategist.md +107 -0
- package/squads/squad-artdir/agents/product-surface-director.md +86 -0
- package/squads/squad-artdir/agents/type-systemist.md +138 -0
- package/squads/squad-artdir/agents/visual-strategist.md +127 -0
- package/squads/squad-artdir/checklists/seven-pillars-validation-checklist.md +172 -0
- package/squads/squad-artdir/knowledge-base/case-nyo-ia-reference.md +289 -0
- package/squads/squad-artdir/knowledge-base/deliverables-templates.md +457 -0
- package/squads/squad-artdir/knowledge-base/motion-technique-catalog.md +247 -0
- package/squads/squad-artdir/knowledge-base/premium-packaging-principles.md +133 -0
- package/squads/squad-artdir/knowledge-base/psychological-toolkit.md +229 -0
- package/squads/squad-artdir/knowledge-base/saas-art-direction-canon.md +242 -0
- package/squads/squad-artdir/knowledge-base/seven-pillars-framework.md +289 -0
- package/squads/squad-artdir/knowledge-base/ten-pillars-framework.md +221 -0
- package/squads/squad-artdir/package.json +20 -0
- package/squads/squad-artdir/squad.yaml +271 -0
- package/squads/squad-artdir/tasks/audit-conversion.md +97 -0
- package/squads/squad-artdir/tasks/audit-drift-multi-surface.md +55 -0
- package/squads/squad-artdir/tasks/consult-saas-canon.md +54 -0
- package/squads/squad-artdir/tasks/create-art-direction-brief.md +110 -0
- package/squads/squad-artdir/tasks/create-premium-packaging-brief.md +61 -0
- package/squads/squad-artdir/tasks/create-wireflow.md +84 -0
- package/squads/squad-artdir/tasks/design-color-system.md +81 -0
- package/squads/squad-artdir/tasks/design-product-surface.md +60 -0
- package/squads/squad-artdir/tasks/design-token-system.md +58 -0
- package/squads/squad-artdir/tasks/diagnose-visual-language.md +92 -0
- package/squads/squad-artdir/tasks/first-5-minutes-choreography.md +65 -0
- package/squads/squad-artdir/tasks/specify-motion-system.md +84 -0
- package/squads/squad-artdir/tasks/validate-against-pillars.md +143 -0
- package/squads/squad-artdir/templates/art-direction-brief-template.md +215 -0
- package/squads/squad-artdir/workflows/conversion-audit-cycle.yaml +78 -0
- package/squads/squad-artdir/workflows/full-art-direction-cycle.yaml +98 -0
- package/squads/squad-artdir/workflows/saas-platform-art-direction-cycle.yaml +174 -0
- package/squads/squad-brand/knowledge-base/ai-visual-generation-canon.md +234 -0
- package/squads/squad-brand/knowledge-base/archetype-brand-mapping.md +12 -1
- package/squads/squad-brand/knowledge-base/brand-activism-cultural-branding.md +216 -0
- package/squads/squad-brand/knowledge-base/brand-audit-criteria.md +58 -0
- package/squads/squad-brand/knowledge-base/brand-digital-strategy.md +188 -0
- package/squads/squad-brand/knowledge-base/brand-legal-ip.md +222 -0
- package/squads/squad-brand/knowledge-base/brand-naming-framework.md +163 -0
- package/squads/squad-brand/knowledge-base/branding-master-reference.md +1001 -0
- package/squads/squad-brand/knowledge-base/color-psychology.md +25 -12
- package/squads/squad-brand/knowledge-base/employer-personal-branding.md +206 -0
- package/squads/squad-brand/knowledge-base/routing-catalog.md +34 -0
- package/squads/squad-brand/knowledge-base/sonic-branding-principles.md +6 -1
- package/squads/squad-brand/knowledge-base/typography-personality.md +34 -0
- package/squads/squad-brand/squad.yaml +20 -6
- package/squads/squad-claude/knowledge-base/context-window-optimization.md +334 -0
- package/squads/squad-claude/knowledge-base/knowledge-architecture-reference.md +403 -0
- package/squads/squad-claude/knowledge-base/memory-systems-reference.md +412 -0
- package/squads/squad-claude/knowledge-base/obsidian-claude-integration.md +423 -0
- package/squads/squad-claude/knowledge-base/retrieval-augmented-generation.md +320 -0
- package/squads/squad-claude/knowledge-base/skill-creation-patterns.md +380 -0
- package/squads/squad-claude/knowledge-base/swarm-orchestration-patterns.md +411 -0
- package/squads/squad-cloning/knowledge-base/clone-quality-assurance.md +211 -0
- package/squads/squad-cloning/knowledge-base/confidence-scoring.md +51 -0
- package/squads/squad-cloning/knowledge-base/cross-squad-deployment.md +47 -0
- package/squads/squad-cloning/knowledge-base/ethical-guidelines.md +237 -0
- package/squads/squad-cloning/knowledge-base/knowledge-graph-for-clones.md +295 -0
- package/squads/squad-cloning/knowledge-base/memory-architecture-for-clones.md +229 -0
- package/squads/squad-cloning/knowledge-base/multi-agent-deployment-patterns.md +320 -0
- package/squads/squad-cloning/knowledge-base/skill-standard-for-clones.md +262 -0
- package/squads/squad-cloning/knowledge-base/sop-extraction-guide.md +243 -0
- package/squads/squad-commercial/knowledge-base/account-based-selling.md +206 -0
- package/squads/squad-commercial/knowledge-base/ai-as-competitive-infrastructure.md +14 -0
- package/squads/squad-commercial/knowledge-base/ai-in-sales.md +199 -0
- package/squads/squad-commercial/knowledge-base/brazilian-sales-context.md +195 -0
- package/squads/squad-commercial/knowledge-base/customer-success-operations.md +83 -2
- package/squads/squad-commercial/knowledge-base/prospecting-pipeline-generation.md +69 -0
- package/squads/squad-commercial/knowledge-base/sales-enablement-playbook.md +260 -0
- package/squads/squad-commercial/knowledge-base/sales-methodology-comparison.md +185 -0
- package/squads/squad-commercial/knowledge-base/sales-revenue-master-reference.md +1123 -0
- package/squads/squad-content/knowledge-base/ai-native-content-loop.md +220 -0
- package/squads/squad-content/knowledge-base/brazilian-content-context.md +176 -0
- package/squads/squad-content/knowledge-base/competitor-analysis-methods.md +40 -1
- package/squads/squad-content/knowledge-base/content-architecture-taxonomy.md +206 -0
- package/squads/squad-content/knowledge-base/content-formats-encyclopedia.md +58 -1
- package/squads/squad-content/knowledge-base/content-references-bibliography.md +130 -0
- package/squads/squad-content/knowledge-base/content-strategy-master-reference.md +1097 -0
- package/squads/squad-content/knowledge-base/content-tech-stack.md +150 -0
- package/squads/squad-content/knowledge-base/copywriting-formulas-library.md +188 -0
- package/squads/squad-content/knowledge-base/email-newsletter-strategy.md +161 -0
- package/squads/squad-content/knowledge-base/platform-algorithm-intelligence.md +86 -1
- package/squads/squad-content/knowledge-base/signal-intelligence-v2.md +234 -0
- package/squads/squad-content/knowledge-base/social-algorithms-master-reference.md +1007 -0
- package/squads/squad-content/knowledge-base/task-ownership-map.md +235 -0
- package/squads/squad-content/knowledge-base/video-audio-content-playbook.md +218 -0
- package/squads/squad-content/squad.yaml +187 -27
- package/squads/squad-copy/knowledge-base/ai-copy-human-loop-canon.md +235 -0
- package/squads/squad-copy/knowledge-base/ai-copy-production.md +254 -0
- package/squads/squad-copy/knowledge-base/brazilian-copywriting-context.md +242 -0
- package/squads/squad-copy/knowledge-base/email-copywriting-system.md +299 -0
- package/squads/squad-copy/knowledge-base/landing-page-copy-architecture.md +267 -0
- package/squads/squad-copy/knowledge-base/power-words-catalog.md +205 -0
- package/squads/squad-copy/knowledge-base/seo-copywriting.md +255 -0
- package/squads/squad-copy/knowledge-base/video-script-copywriting.md +239 -0
- package/squads/squad-copy/squad.yaml +19 -4
- package/squads/squad-council/knowledge-base/brand-strategy-models.md +193 -0
- package/squads/squad-council/knowledge-base/growth-strategy-models.md +267 -0
- package/squads/squad-council/knowledge-base/innovation-disruption-frameworks.md +193 -0
- package/squads/squad-council/knowledge-base/market-analysis-frameworks.md +240 -0
- package/squads/squad-council/knowledge-base/organizational-leadership-models.md +212 -0
- package/squads/squad-council/knowledge-base/sales-strategy-models.md +215 -0
- package/squads/squad-courses/knowledge-base/course-launch-strategy.md +251 -0
- package/squads/squad-courses/knowledge-base/domain-advocacia-curriculum.md +385 -0
- package/squads/squad-courses/knowledge-base/domain-contabilidade-curriculum.md +266 -0
- package/squads/squad-courses/knowledge-base/platform-comparison.md +68 -0
- package/squads/squad-courses/knowledge-base/video-production-guide.md +70 -0
- package/squads/squad-cybersecurity/knowledge-base/cloud-security-reference.md +363 -0
- package/squads/squad-cybersecurity/knowledge-base/compliance-frameworks.md +273 -0
- package/squads/squad-cybersecurity/knowledge-base/database-security.md +438 -0
- package/squads/squad-cybersecurity/knowledge-base/incident-response-playbook.md +420 -0
- package/squads/squad-cybersecurity/knowledge-base/network-security-reference.md +477 -0
- package/squads/squad-cybersecurity/knowledge-base/penetration-testing-methodology.md +350 -0
- package/squads/squad-cybersecurity/knowledge-base/vulnerability-management.md +349 -0
- package/squads/squad-design/knowledge-base/brazilian-design-context.md +223 -0
- package/squads/squad-design/knowledge-base/component-api-patterns.md +208 -4
- package/squads/squad-design/knowledge-base/cross-surface-token-canon.md +209 -0
- package/squads/squad-design/knowledge-base/design-system-master-reference.md +1302 -0
- package/squads/squad-design/knowledge-base/design-systems-frameworks.md +91 -1
- package/squads/squad-design/knowledge-base/responsive-modern-css.md +96 -4
- package/squads/squad-design/knowledge-base/wcag-aria-reference.md +117 -5
- package/squads/squad-design/knowledge-base/web-performance-reference.md +127 -4
- package/squads/squad-design/squad.yaml +19 -4
- package/squads/squad-finance/knowledge-base/brazilian-taxation.md +263 -0
- package/squads/squad-finance/knowledge-base/contabilidade-master-reference.md +998 -0
- package/squads/squad-finance/knowledge-base/finance-master-reference.md +946 -0
- package/squads/squad-finance/knowledge-base/financial-reporting-analysis.md +316 -0
- package/squads/squad-finance/knowledge-base/fintech-brazilian-context.md +242 -0
- package/squads/squad-finance/knowledge-base/fpa-planning-frameworks.md +286 -0
- package/squads/squad-finance/knowledge-base/ma-and-transactions.md +285 -0
- package/squads/squad-finance/knowledge-base/risk-management.md +233 -0
- package/squads/squad-finance/knowledge-base/startups-venture-capital.md +337 -0
- package/squads/squad-growth/knowledge-base/ai-growth-playbook.md +216 -0
- package/squads/squad-growth/knowledge-base/attribution-models.md +78 -0
- package/squads/squad-growth/knowledge-base/brazilian-growth-context.md +208 -0
- package/squads/squad-growth/knowledge-base/community-led-growth.md +175 -0
- package/squads/squad-growth/knowledge-base/content-marketing-flywheel.md +190 -0
- package/squads/squad-growth/knowledge-base/email-lifecycle-framework.md +192 -0
- package/squads/squad-growth/knowledge-base/growth-frameworks-catalog.md +82 -0
- package/squads/squad-growth/knowledge-base/growth-master-reference.md +1168 -0
- package/squads/squad-growth/knowledge-base/routing-catalog.md +53 -11
- package/squads/squad-paidmedia/knowledge-base/audiences-segmentation-deep.md +285 -0
- package/squads/squad-paidmedia/knowledge-base/creative-strategy-deep.md +294 -0
- package/squads/squad-paidmedia/knowledge-base/google-ads-account-architecture.md +87 -0
- package/squads/squad-paidmedia/knowledge-base/meta-ads-campaign-architecture.md +76 -0
- package/squads/squad-paidmedia/knowledge-base/paid-media-metrics-reference.md +117 -0
- package/squads/squad-paidmedia/knowledge-base/paid-traffic-master-reference.md +1308 -0
- package/squads/squad-paidmedia/knowledge-base/routing-catalog.md +95 -18
- package/squads/squad-paidmedia/knowledge-base/traffic-masters-frameworks.md +71 -0
- package/squads/squad-product/knowledge-base/brazilian-product-context.md +284 -0
- package/squads/squad-product/knowledge-base/discovery-methodology-playbook.md +141 -0
- package/squads/squad-product/knowledge-base/pm-frameworks-reference.md +125 -9
- package/squads/squad-product/knowledge-base/product-analytics-formulas.md +72 -0
- package/squads/squad-product/knowledge-base/product-led-growth-reference.md +155 -13
- package/squads/squad-product/knowledge-base/product-market-fit-framework.md +222 -0
- package/squads/squad-product/knowledge-base/routing-catalog.md +32 -0
- package/squads/squad-research/knowledge-base/agentic-second-brain-reference.md +591 -0
- package/squads/squad-research/knowledge-base/ai-augmented-research.md +212 -0
- package/squads/squad-research/knowledge-base/brazilian-market-research-sources.md +197 -0
- package/squads/squad-research/knowledge-base/community-platforms-reference.md +786 -0
- package/squads/squad-research/knowledge-base/community-research-methods.md +194 -0
- package/squads/squad-research/knowledge-base/mixed-methods-research-design.md +168 -0
- package/squads/squad-research/knowledge-base/network-effects-analysis.md +192 -0
- package/squads/squad-research/knowledge-base/qualitative-research-deep-methods.md +202 -0
- package/squads/squad-research/knowledge-base/quantitative-research-methods.md +208 -0
- package/squads/squad-research/knowledge-base/research-frameworks-encyclopedia.md +40 -0
- package/squads/squad-research/knowledge-base/research-synthesis-frameworks.md +223 -0
- package/squads/squad-storytelling/knowledge-base/brand-mythology-framework.md +236 -0
- package/squads/squad-storytelling/knowledge-base/brazilian-storytelling-context.md +237 -0
- package/squads/squad-storytelling/knowledge-base/data-storytelling.md +232 -0
- package/squads/squad-storytelling/knowledge-base/improv-storytelling.md +226 -0
- package/squads/squad-storytelling/knowledge-base/persuasion-narrative-techniques.md +269 -0
- package/squads/squad-storytelling/knowledge-base/social-movement-narratives.md +191 -0
- package/squads/squad-storytelling/knowledge-base/video-storytelling.md +252 -0
- package/.sinapse-ai/core/registry/service-registry.json +0 -6346
- package/.sinapse-ai/data/registry-update-log.jsonl +0 -1307
- package/.sinapse-ai/manifests/agents.csv +0 -29
- package/.sinapse-ai/manifests/tasks.csv +0 -204
- package/.sinapse-ai/manifests/workers.csv +0 -196
- package/squads/claude-code-mastery/data/swarm-orchestration-patterns.yaml +0 -378
- package/squads/squad-animations/knowledge-base/framer-motion-complete-reference.md +0 -710
- package/squads/squad-animations/knowledge-base/web-animations-api-view-transitions.md +0 -478
- package/squads/squad-growth/tasks/calculate-sample-size.md +0 -121
- 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)*
|