@polymorphism-tech/morph-spec 3.0.0 → 3.0.1

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 (160) hide show
  1. package/CLAUDE.md +75 -371
  2. package/LICENSE +72 -72
  3. package/bin/detect-agents.js +225 -225
  4. package/bin/render-template.js +302 -302
  5. package/bin/semantic-detect-agents.js +246 -246
  6. package/bin/validate-agents-skills.js +251 -251
  7. package/bin/validate-agents.js +69 -69
  8. package/bin/validate-phase.js +263 -263
  9. package/content/.azure/README.md +293 -293
  10. package/content/.azure/docs/azure-devops-setup.md +454 -454
  11. package/content/.azure/docs/branch-strategy.md +398 -398
  12. package/content/.azure/docs/local-development.md +515 -515
  13. package/content/.azure/pipelines/pipeline-variables.yml +34 -34
  14. package/content/.azure/pipelines/prod-pipeline.yml +319 -319
  15. package/content/.azure/pipelines/staging-pipeline.yml +234 -234
  16. package/content/.azure/pipelines/templates/build-dotnet.yml +75 -75
  17. package/content/.azure/pipelines/templates/deploy-app-service.yml +94 -94
  18. package/content/.azure/pipelines/templates/deploy-container-app.yml +120 -120
  19. package/content/.azure/pipelines/templates/infra-deploy.yml +90 -90
  20. package/content/.claude/commands/morph-archive.md +79 -79
  21. package/content/.claude/commands/morph-deploy.md +529 -529
  22. package/content/.claude/commands/morph-infra.md +209 -209
  23. package/content/.claude/commands/morph-preflight.md +227 -227
  24. package/content/.claude/commands/morph-troubleshoot.md +122 -122
  25. package/content/.claude/settings.local.json +15 -15
  26. package/content/.claude/skills/{specialists → level-2-domains/architecture}/prompt-engineer.md +189 -189
  27. package/content/.claude/skills/{specialists → level-2-domains/architecture}/seo-growth-hacker.md +320 -320
  28. package/content/.claude/skills/{infra → level-2-domains/infrastructure}/azure-deploy-specialist.md +699 -699
  29. package/content/.morph/.morphversion +5 -5
  30. package/content/.morph/archive/.gitkeep +25 -25
  31. package/content/.morph/config/agents.json +7 -5
  32. package/content/.morph/docs/STORY-DRIVEN-DEVELOPMENT.md +392 -392
  33. package/content/.morph/examples/api-nextjs/README.md +241 -241
  34. package/content/.morph/examples/api-nextjs/contracts.ts +307 -307
  35. package/content/.morph/examples/api-nextjs/spec.md +399 -399
  36. package/content/.morph/examples/api-nextjs/tasks.md +168 -168
  37. package/content/.morph/examples/micro-saas/README.md +125 -125
  38. package/content/.morph/examples/micro-saas/contracts.cs +358 -358
  39. package/content/.morph/examples/micro-saas/decisions.md +246 -246
  40. package/content/.morph/examples/micro-saas/spec.md +236 -236
  41. package/content/.morph/examples/micro-saas/tasks.md +150 -150
  42. package/content/.morph/examples/multi-agent/README.md +309 -309
  43. package/content/.morph/examples/multi-agent/contracts.cs +433 -433
  44. package/content/.morph/examples/multi-agent/spec.md +479 -479
  45. package/content/.morph/examples/multi-agent/tasks.md +185 -185
  46. package/content/.morph/examples/state-v3.json +188 -188
  47. package/content/.morph/features/.gitkeep +25 -25
  48. package/content/.morph/hooks/pre-commit-all.sh +48 -48
  49. package/content/.morph/hooks/pre-commit-specs.sh +49 -49
  50. package/content/.morph/hooks/pre-commit-tests.sh +60 -60
  51. package/content/.morph/project.md +160 -160
  52. package/content/.morph/schemas/agent.schema.json +296 -296
  53. package/content/.morph/specs/.gitkeep +20 -20
  54. package/content/.morph/standards/coding.md +377 -377
  55. package/content/.morph/standards/fluent-ui-setup.md +590 -590
  56. package/content/.morph/standards/migration-guide.md +514 -514
  57. package/content/.morph/standards/passkeys-auth.md +423 -423
  58. package/content/.morph/standards/vector-search-rag.md +536 -536
  59. package/content/.morph/state.json +17 -17
  60. package/content/.morph/templates/FluentDesignTheme.cs +149 -149
  61. package/content/.morph/templates/MudTheme.cs +281 -281
  62. package/content/.morph/templates/component.razor +239 -239
  63. package/content/.morph/templates/contracts.cs +217 -217
  64. package/content/.morph/templates/design-system.css +226 -226
  65. package/content/.morph/templates/infra/.dockerignore.example +89 -89
  66. package/content/.morph/templates/infra/Dockerfile.example +82 -82
  67. package/content/.morph/templates/infra/README.md +286 -286
  68. package/content/.morph/templates/infra/app-insights.bicep +63 -63
  69. package/content/.morph/templates/infra/app-service.bicep +164 -164
  70. package/content/.morph/templates/infra/azure-pipelines-deploy.yml +480 -480
  71. package/content/.morph/templates/infra/container-app-env.bicep +49 -49
  72. package/content/.morph/templates/infra/container-app.bicep +156 -156
  73. package/content/.morph/templates/infra/deploy-checklist.md +426 -426
  74. package/content/.morph/templates/infra/deploy.ps1 +229 -229
  75. package/content/.morph/templates/infra/deploy.sh +208 -208
  76. package/content/.morph/templates/infra/key-vault.bicep +91 -91
  77. package/content/.morph/templates/infra/main.bicep +189 -189
  78. package/content/.morph/templates/infra/parameters.dev.json +29 -29
  79. package/content/.morph/templates/infra/parameters.prod.json +29 -29
  80. package/content/.morph/templates/infra/parameters.staging.json +29 -29
  81. package/content/.morph/templates/infra/sql-database.bicep +103 -103
  82. package/content/.morph/templates/infra/storage.bicep +106 -106
  83. package/content/.morph/templates/integrations/asaas-client.cs +387 -387
  84. package/content/.morph/templates/integrations/asaas-webhook.cs +351 -351
  85. package/content/.morph/templates/integrations/azure-identity-config.cs +288 -288
  86. package/content/.morph/templates/integrations/clerk-config.cs +258 -258
  87. package/content/.morph/templates/job.cs +171 -171
  88. package/content/.morph/templates/migration.cs +83 -83
  89. package/content/.morph/templates/repository.cs +141 -141
  90. package/content/.morph/templates/saas/subscription.cs +347 -347
  91. package/content/.morph/templates/saas/tenant.cs +338 -338
  92. package/content/.morph/templates/service.cs +139 -139
  93. package/content/.morph/templates/sprint-status.yaml +68 -68
  94. package/content/.morph/templates/story.md +143 -143
  95. package/content/.morph/templates/test.cs +239 -239
  96. package/content/.morph/templates/ui-design-system.md +286 -286
  97. package/content/.morph/templates/ui-flows.md +336 -336
  98. package/content/.morph/templates/ui-mockups.md +133 -133
  99. package/content/.morph/test-infra/example.bicep +59 -59
  100. package/content/README.md +79 -79
  101. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.svg +977 -977
  102. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.svg +1048 -1048
  103. package/docs/api/scripts/collapse.js +38 -38
  104. package/docs/api/scripts/commonNav.js +28 -28
  105. package/docs/api/scripts/linenumber.js +25 -25
  106. package/docs/api/scripts/nav.js +12 -12
  107. package/docs/api/scripts/polyfill.js +3 -3
  108. package/docs/api/scripts/prettify/Apache-License-2.0.txt +202 -202
  109. package/docs/api/scripts/prettify/lang-css.js +2 -2
  110. package/docs/api/scripts/prettify/prettify.js +28 -28
  111. package/docs/api/scripts/search.js +98 -98
  112. package/docs/api/styles/jsdoc.css +776 -776
  113. package/docs/api/styles/prettify.css +80 -80
  114. package/docs/examples.md +328 -328
  115. package/docs/templates.md +418 -418
  116. package/package.json +1 -2
  117. package/scripts/postinstall.js +132 -132
  118. package/scripts/reorganize-skills.cjs +175 -0
  119. package/scripts/validate-agents-structure.cjs +52 -0
  120. package/scripts/validate-skills.cjs +180 -0
  121. package/src/commands/analyze-blazor-concurrency.js +193 -193
  122. package/src/commands/create-story.js +351 -351
  123. package/src/commands/deploy.js +780 -780
  124. package/src/commands/detect-agents.js +9 -0
  125. package/src/commands/detect.js +104 -104
  126. package/src/commands/generate.js +149 -149
  127. package/src/commands/lint-fluent.js +352 -352
  128. package/src/commands/rollback-phase.js +185 -185
  129. package/src/commands/session-summary.js +291 -291
  130. package/src/commands/shard-spec.js +224 -224
  131. package/src/commands/sprint-status.js +250 -250
  132. package/src/commands/state.js +334 -333
  133. package/src/commands/sync.js +167 -167
  134. package/src/commands/troubleshoot.js +222 -222
  135. package/src/commands/update.js +13 -1
  136. package/src/commands/validate-blazor-state.js +210 -210
  137. package/src/commands/validate-blazor.js +156 -156
  138. package/src/commands/validate-css.js +84 -84
  139. package/src/commands/validate-phase.js +221 -221
  140. package/src/lib/blazor-concurrency-analyzer.js +288 -288
  141. package/src/lib/blazor-state-validator.js +291 -291
  142. package/src/lib/blazor-validator.js +374 -374
  143. package/src/lib/css-validator.js +352 -352
  144. package/src/lib/design-system-generator.js +298 -298
  145. package/{detectors → src/lib/detectors}/config-detector.js +223 -223
  146. package/{detectors → src/lib/detectors}/conversation-analyzer.js +163 -163
  147. package/{detectors → src/lib/detectors}/index.js +84 -84
  148. package/{detectors → src/lib/detectors}/standards-generator.js +275 -275
  149. package/src/lib/learning-system.js +520 -520
  150. package/src/lib/mockup-generator.js +366 -366
  151. package/src/lib/state-manager.js +21 -4
  152. package/src/lib/troubleshoot-grep.js +194 -194
  153. package/src/lib/troubleshoot-index.js +144 -144
  154. package/src/lib/ui-detector.js +350 -350
  155. package/src/lib/validators/architecture-validator.js +387 -387
  156. package/src/lib/validators/package-validator.js +360 -360
  157. package/src/lib/validators/ui-contrast-validator.js +422 -422
  158. package/src/utils/logger.js +32 -32
  159. package/src/utils/version-checker.js +175 -175
  160. /package/{detectors → src/lib/detectors}/structure-detector.js +0 -0
@@ -1,60 +1,60 @@
1
- #!/bin/bash
2
- # MORPH-SPEC Pre-Commit Hook: Test Coverage
3
- # Ensures new code has corresponding tests
4
-
5
- echo "🧪 Checking test coverage..."
6
-
7
- # Find modified C# files (excluding tests)
8
- CS_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep '\.cs$' | grep -v 'Tests\|Test\.cs$')
9
-
10
- if [ -z "$CS_FILES" ]; then
11
- echo "✓ No production code modified"
12
- exit 0
13
- fi
14
-
15
- MISSING_TESTS=false
16
-
17
- for cs_file in $CS_FILES; do
18
- # Extract class name
19
- class_name=$(basename "$cs_file" .cs)
20
-
21
- # Look for corresponding test file
22
- test_patterns=(
23
- "*/${class_name}Tests.cs"
24
- "*/${class_name}Test.cs"
25
- "*/Test${class_name}.cs"
26
- )
27
-
28
- FOUND_TEST=false
29
- for pattern in "${test_patterns[@]}"; do
30
- if find . -path "$pattern" 2>/dev/null | grep -q .; then
31
- FOUND_TEST=true
32
- break
33
- fi
34
- done
35
-
36
- if [ "$FOUND_TEST" = false ]; then
37
- # Check if it's a trivial file (DTO, model, etc.)
38
- if grep -qi 'record\|DTO\|Model\|Entity' "$cs_file" && ! grep -qi 'class.*{.*public.*{' "$cs_file"; then
39
- echo " ℹ️ Skipping trivial file: $cs_file"
40
- continue
41
- fi
42
-
43
- echo " ⚠️ No test found for: $cs_file"
44
- MISSING_TESTS=true
45
- else
46
- echo " ✓ Test found for: $cs_file"
47
- fi
48
- done
49
-
50
- if [ "$MISSING_TESTS" = true ]; then
51
- echo ""
52
- echo "⚠️ WARNING: Some files don't have tests"
53
- echo " Consider adding tests before committing"
54
- echo " Override with: git commit --no-verify"
55
- # Don't block, just warn
56
- exit 0
57
- fi
58
-
59
- echo "✓ Test coverage looks good"
60
- exit 0
1
+ #!/bin/bash
2
+ # MORPH-SPEC Pre-Commit Hook: Test Coverage
3
+ # Ensures new code has corresponding tests
4
+
5
+ echo "🧪 Checking test coverage..."
6
+
7
+ # Find modified C# files (excluding tests)
8
+ CS_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep '\.cs$' | grep -v 'Tests\|Test\.cs$')
9
+
10
+ if [ -z "$CS_FILES" ]; then
11
+ echo "✓ No production code modified"
12
+ exit 0
13
+ fi
14
+
15
+ MISSING_TESTS=false
16
+
17
+ for cs_file in $CS_FILES; do
18
+ # Extract class name
19
+ class_name=$(basename "$cs_file" .cs)
20
+
21
+ # Look for corresponding test file
22
+ test_patterns=(
23
+ "*/${class_name}Tests.cs"
24
+ "*/${class_name}Test.cs"
25
+ "*/Test${class_name}.cs"
26
+ )
27
+
28
+ FOUND_TEST=false
29
+ for pattern in "${test_patterns[@]}"; do
30
+ if find . -path "$pattern" 2>/dev/null | grep -q .; then
31
+ FOUND_TEST=true
32
+ break
33
+ fi
34
+ done
35
+
36
+ if [ "$FOUND_TEST" = false ]; then
37
+ # Check if it's a trivial file (DTO, model, etc.)
38
+ if grep -qi 'record\|DTO\|Model\|Entity' "$cs_file" && ! grep -qi 'class.*{.*public.*{' "$cs_file"; then
39
+ echo " ℹ️ Skipping trivial file: $cs_file"
40
+ continue
41
+ fi
42
+
43
+ echo " ⚠️ No test found for: $cs_file"
44
+ MISSING_TESTS=true
45
+ else
46
+ echo " ✓ Test found for: $cs_file"
47
+ fi
48
+ done
49
+
50
+ if [ "$MISSING_TESTS" = true ]; then
51
+ echo ""
52
+ echo "⚠️ WARNING: Some files don't have tests"
53
+ echo " Consider adding tests before committing"
54
+ echo " Override with: git commit --no-verify"
55
+ # Don't block, just warn
56
+ exit 0
57
+ fi
58
+
59
+ echo "✓ Test coverage looks good"
60
+ exit 0
@@ -1,160 +1,160 @@
1
- # Project Context - {PROJECT_NAME}
2
-
3
- > Este arquivo define o contexto do projeto para os agentes MORPH.
4
- > Preencha com as informações específicas do seu projeto.
5
-
6
- ## Overview
7
-
8
- **Nome:** {PROJECT_NAME}
9
- **Descrição:** {Breve descrição do projeto}
10
- **Tipo:** Blazor Server Application
11
-
12
- ---
13
-
14
- ## Technical Stack
15
-
16
- | Layer | Technology | Version |
17
- |-------|------------|---------|
18
- | Frontend | Blazor Server | .NET 10 |
19
- | UI Library | Fluent UI Blazor (recomendado) | 4.0+ |
20
- | Backend | ASP.NET Core | 10.0 |
21
- | Database | Azure SQL | Free Tier |
22
- | ORM | Entity Framework Core | 10.0 |
23
- | AI | Microsoft Agent Framework | .NET 10 |
24
- | Jobs | Hangfire | Latest |
25
- | Hosting | Azure Container Apps | Consumption |
26
-
27
- ---
28
-
29
- ## Architecture
30
-
31
- ```
32
- ┌─────────────────────────────────────────────────┐
33
- │ Web (Blazor) │
34
- ├─────────────────────────────────────────────────┤
35
- │ Application (Services) │
36
- ├─────────────────────────────────────────────────┤
37
- │ Domain (Entities) │
38
- ├─────────────────────────────────────────────────┤
39
- │ Infrastructure (EF Core) │
40
- ├─────────────────────────────────────────────────┤
41
- │ Agents (AI Services) │
42
- └─────────────────────────────────────────────────┘
43
- ```
44
-
45
- ### Project Structure
46
-
47
- ```
48
- src/
49
- ├── {Project}.Web/ # Blazor Server
50
- ├── {Project}.Application/ # Services, DTOs, Commands
51
- ├── {Project}.Domain/ # Entities, Value Objects
52
- ├── {Project}.Infrastructure/ # EF Core, Repositories
53
- └── {Project}.Agents/ # AI Agents
54
-
55
- tests/
56
- ├── {Project}.Tests.Unit/
57
- └── {Project}.Tests.Integration/
58
- ```
59
-
60
- ---
61
-
62
- ## Conventions
63
-
64
- ### Naming
65
-
66
- - **Classes:** PascalCase (ex: `ReportScheduleService`)
67
- - **Interfaces:** I + PascalCase (ex: `IReportScheduleService`)
68
- - **Methods:** PascalCase, async com sufixo Async (ex: `GetByIdAsync`)
69
- - **Variables:** camelCase (ex: `reportSchedule`)
70
- - **Private fields:** _camelCase (ex: `_repository`)
71
-
72
- ### Code Style
73
-
74
- - Primary constructors (C# 12+)
75
- - Records para DTOs
76
- - Private setters em entidades
77
- - Factory methods para criação de entidades
78
- - Fluent API para EF Core (nunca Data Annotations)
79
-
80
- ### Documentation
81
-
82
- - Documentação em Português
83
- - Código em Inglês
84
- - XML comments em métodos públicos
85
-
86
- ---
87
-
88
- ## Azure Resources
89
-
90
- | Resource | Name | Tier |
91
- |----------|------|------|
92
- | Resource Group | rg-{project}-{env} | - |
93
- | Container App | ca-{project}-{env} | Consumption |
94
- | SQL Server | sql-{project}-{env} | Free |
95
- | SQL Database | sqldb-{project}-{env} | Free 32GB |
96
- | App Insights | appi-{project}-{env} | Free 5GB |
97
-
98
- ### Cost Limits
99
-
100
- - **Sem aprovação:** Free tier apenas
101
- - **Com aprovação:** Até $10/mês
102
- - **Acima de $10:** Requer ADR com justificativa
103
-
104
- ---
105
-
106
- ## Authentication & Authorization
107
-
108
- - [ ] Azure AD / Entra ID
109
- - [ ] Identity Server
110
- - [ ] Custom JWT
111
- - [ ] None (internal tool)
112
-
113
- **Policies definidas:**
114
- - `CanView{Feature}` - Visualização
115
- - `CanManage{Feature}` - CRUD completo
116
- - `IsAdmin` - Acesso total
117
-
118
- ---
119
-
120
- ## External Integrations
121
-
122
- | Service | Purpose | Auth Method |
123
- |---------|---------|-------------|
124
- | Azure OpenAI | AI Analysis | Managed Identity |
125
- | {Service} | {Purpose} | {Method} |
126
-
127
- ---
128
-
129
- ## Development Guidelines
130
-
131
- ### Git Flow
132
-
133
- - **main** - Produção
134
- - **develop** - Desenvolvimento
135
- - **feature/{name}** - Features
136
-
137
- ### Commit Convention
138
-
139
- ```
140
- {type}({scope}): {message}
141
-
142
- Types: feat, fix, docs, style, refactor, test, chore
143
- ```
144
-
145
- ### PR Requirements
146
-
147
- - [ ] Testes passando
148
- - [ ] Code review aprovado
149
- - [ ] Sem conflitos
150
- - [ ] Linked to work item
151
-
152
- ---
153
-
154
- ## Notes
155
-
156
- {Adicione notas específicas do projeto aqui}
157
-
158
- ---
159
-
160
- *Gerado pelo MORPH Framework*
1
+ # Project Context - {PROJECT_NAME}
2
+
3
+ > Este arquivo define o contexto do projeto para os agentes MORPH.
4
+ > Preencha com as informações específicas do seu projeto.
5
+
6
+ ## Overview
7
+
8
+ **Nome:** {PROJECT_NAME}
9
+ **Descrição:** {Breve descrição do projeto}
10
+ **Tipo:** Blazor Server Application
11
+
12
+ ---
13
+
14
+ ## Technical Stack
15
+
16
+ | Layer | Technology | Version |
17
+ |-------|------------|---------|
18
+ | Frontend | Blazor Server | .NET 10 |
19
+ | UI Library | Fluent UI Blazor (recomendado) | 4.0+ |
20
+ | Backend | ASP.NET Core | 10.0 |
21
+ | Database | Azure SQL | Free Tier |
22
+ | ORM | Entity Framework Core | 10.0 |
23
+ | AI | Microsoft Agent Framework | .NET 10 |
24
+ | Jobs | Hangfire | Latest |
25
+ | Hosting | Azure Container Apps | Consumption |
26
+
27
+ ---
28
+
29
+ ## Architecture
30
+
31
+ ```
32
+ ┌─────────────────────────────────────────────────┐
33
+ │ Web (Blazor) │
34
+ ├─────────────────────────────────────────────────┤
35
+ │ Application (Services) │
36
+ ├─────────────────────────────────────────────────┤
37
+ │ Domain (Entities) │
38
+ ├─────────────────────────────────────────────────┤
39
+ │ Infrastructure (EF Core) │
40
+ ├─────────────────────────────────────────────────┤
41
+ │ Agents (AI Services) │
42
+ └─────────────────────────────────────────────────┘
43
+ ```
44
+
45
+ ### Project Structure
46
+
47
+ ```
48
+ src/
49
+ ├── {Project}.Web/ # Blazor Server
50
+ ├── {Project}.Application/ # Services, DTOs, Commands
51
+ ├── {Project}.Domain/ # Entities, Value Objects
52
+ ├── {Project}.Infrastructure/ # EF Core, Repositories
53
+ └── {Project}.Agents/ # AI Agents
54
+
55
+ tests/
56
+ ├── {Project}.Tests.Unit/
57
+ └── {Project}.Tests.Integration/
58
+ ```
59
+
60
+ ---
61
+
62
+ ## Conventions
63
+
64
+ ### Naming
65
+
66
+ - **Classes:** PascalCase (ex: `ReportScheduleService`)
67
+ - **Interfaces:** I + PascalCase (ex: `IReportScheduleService`)
68
+ - **Methods:** PascalCase, async com sufixo Async (ex: `GetByIdAsync`)
69
+ - **Variables:** camelCase (ex: `reportSchedule`)
70
+ - **Private fields:** _camelCase (ex: `_repository`)
71
+
72
+ ### Code Style
73
+
74
+ - Primary constructors (C# 12+)
75
+ - Records para DTOs
76
+ - Private setters em entidades
77
+ - Factory methods para criação de entidades
78
+ - Fluent API para EF Core (nunca Data Annotations)
79
+
80
+ ### Documentation
81
+
82
+ - Documentação em Português
83
+ - Código em Inglês
84
+ - XML comments em métodos públicos
85
+
86
+ ---
87
+
88
+ ## Azure Resources
89
+
90
+ | Resource | Name | Tier |
91
+ |----------|------|------|
92
+ | Resource Group | rg-{project}-{env} | - |
93
+ | Container App | ca-{project}-{env} | Consumption |
94
+ | SQL Server | sql-{project}-{env} | Free |
95
+ | SQL Database | sqldb-{project}-{env} | Free 32GB |
96
+ | App Insights | appi-{project}-{env} | Free 5GB |
97
+
98
+ ### Cost Limits
99
+
100
+ - **Sem aprovação:** Free tier apenas
101
+ - **Com aprovação:** Até $10/mês
102
+ - **Acima de $10:** Requer ADR com justificativa
103
+
104
+ ---
105
+
106
+ ## Authentication & Authorization
107
+
108
+ - [ ] Azure AD / Entra ID
109
+ - [ ] Identity Server
110
+ - [ ] Custom JWT
111
+ - [ ] None (internal tool)
112
+
113
+ **Policies definidas:**
114
+ - `CanView{Feature}` - Visualização
115
+ - `CanManage{Feature}` - CRUD completo
116
+ - `IsAdmin` - Acesso total
117
+
118
+ ---
119
+
120
+ ## External Integrations
121
+
122
+ | Service | Purpose | Auth Method |
123
+ |---------|---------|-------------|
124
+ | Azure OpenAI | AI Analysis | Managed Identity |
125
+ | {Service} | {Purpose} | {Method} |
126
+
127
+ ---
128
+
129
+ ## Development Guidelines
130
+
131
+ ### Git Flow
132
+
133
+ - **main** - Produção
134
+ - **develop** - Desenvolvimento
135
+ - **feature/{name}** - Features
136
+
137
+ ### Commit Convention
138
+
139
+ ```
140
+ {type}({scope}): {message}
141
+
142
+ Types: feat, fix, docs, style, refactor, test, chore
143
+ ```
144
+
145
+ ### PR Requirements
146
+
147
+ - [ ] Testes passando
148
+ - [ ] Code review aprovado
149
+ - [ ] Sem conflitos
150
+ - [ ] Linked to work item
151
+
152
+ ---
153
+
154
+ ## Notes
155
+
156
+ {Adicione notas específicas do projeto aqui}
157
+
158
+ ---
159
+
160
+ *Gerado pelo MORPH Framework*