start-vibing 1.1.2 → 1.1.3

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 (39) hide show
  1. package/package.json +1 -1
  2. package/template/.claude/CLAUDE.md +129 -168
  3. package/template/.claude/README.md +135 -126
  4. package/template/.claude/agents/analyzer.md +0 -14
  5. package/template/.claude/agents/commit-manager.md +0 -19
  6. package/template/.claude/agents/documenter.md +0 -10
  7. package/template/.claude/agents/domain-updater.md +194 -200
  8. package/template/.claude/agents/final-validator.md +0 -18
  9. package/template/.claude/agents/orchestrator.md +0 -12
  10. package/template/.claude/agents/quality-checker.md +0 -24
  11. package/template/.claude/agents/research.md +251 -262
  12. package/template/.claude/agents/security-auditor.md +1 -14
  13. package/template/.claude/agents/tester.md +0 -8
  14. package/template/.claude/agents/ui-ux-reviewer.md +0 -8
  15. package/template/.claude/commands/feature.md +48 -102
  16. package/template/.claude/config/README.md +30 -30
  17. package/template/.claude/config/domain-mapping.json +55 -26
  18. package/template/.claude/config/project-config.json +56 -53
  19. package/template/.claude/config/quality-gates.json +46 -46
  20. package/template/.claude/config/security-rules.json +45 -45
  21. package/template/.claude/config/testing-config.json +168 -168
  22. package/template/.claude/hooks/SETUP.md +52 -181
  23. package/template/.claude/hooks/user-prompt-submit.py +37 -246
  24. package/template/.claude/settings.json +39 -267
  25. package/template/.claude/skills/codebase-knowledge/SKILL.md +71 -145
  26. package/template/.claude/skills/codebase-knowledge/domains/claude-system.md +54 -321
  27. package/template/.claude/skills/docs-tracker/SKILL.md +63 -239
  28. package/template/.claude/skills/final-check/SKILL.md +72 -284
  29. package/template/.claude/skills/quality-gate/SKILL.md +71 -278
  30. package/template/.claude/skills/research-cache/SKILL.md +73 -207
  31. package/template/.claude/skills/security-scan/SKILL.md +75 -206
  32. package/template/.claude/skills/test-coverage/SKILL.md +66 -441
  33. package/template/.claude/skills/ui-ux-audit/SKILL.md +68 -254
  34. package/template/.claude/hooks/post-tool-use.py +0 -155
  35. package/template/.claude/hooks/pre-tool-use.py +0 -159
  36. package/template/.claude/hooks/stop-validation.py +0 -155
  37. package/template/.claude/hooks/validate-commit.py +0 -200
  38. package/template/.claude/hooks/workflow-manager.py +0 -350
  39. package/template/.claude/workflow-state.schema.json +0 -200
@@ -1,102 +1,48 @@
1
- # /feature - Iniciar Nova Feature
2
-
3
- ---
4
-
5
- command: feature
6
- description: Inicia o fluxo completo para uma nova feature
7
- usage: /feature [descricao da feature]
8
-
9
- ---
10
-
11
- ## PASSO 1: INICIAR WORKFLOW (OBRIGATORIO)
12
-
13
- **EXECUTE IMEDIATAMENTE antes de qualquer outra acao:**
14
-
15
- ```bash
16
- python "$CLAUDE_PROJECT_DIR/.claude/hooks/workflow-manager.py" start-task --type feature --description "$ARGUMENTS"
17
- ```
18
-
19
- Se o comando acima falhar, informe o usuario e NAO prossiga.
20
-
21
- ---
22
-
23
- ## PASSO 2: EXECUTAR ANALYZER
24
-
25
- Leia o arquivo `.claude/agents/analyzer.md` e execute as instrucoes.
26
-
27
- Ao final, execute:
28
-
29
- ```bash
30
- python "$CLAUDE_PROJECT_DIR/.claude/hooks/workflow-manager.py" agent-executed --agent analyzer --result approved
31
- python "$CLAUDE_PROJECT_DIR/.claude/hooks/workflow-manager.py" approve-files --files "[arquivos identificados]"
32
- ```
33
-
34
- **IMPORTANTE:** Sem aprovar arquivos, os hooks bloqueiarao qualquer edicao!
35
-
36
- ---
37
-
38
- ## PASSO 3: FLUXO DE AGENTES
39
-
40
- Execute na ordem (leia cada arquivo .md antes):
41
-
42
- | Ordem | Agente | Arquivo | Quando |
43
- | ----- | ----------------- | ------------------------------------ | --------- |
44
- | 1 | analyzer | `.claude/agents/analyzer.md` | Sempre |
45
- | 2 | ui-ux-reviewer | `.claude/agents/ui-ux-reviewer.md` | Se tem UI |
46
- | 3 | documenter | `.claude/agents/documenter.md` | Sempre |
47
- | 4 | **[IMPLEMENTAR]** | - | - |
48
- | 5 | tester | `.claude/agents/tester.md` | Sempre |
49
- | 6 | security-auditor | `.claude/agents/security-auditor.md` | Sempre |
50
- | 7 | quality-checker | `.claude/agents/quality-checker.md` | Sempre |
51
- | 8 | final-validator | `.claude/agents/final-validator.md` | Sempre |
52
-
53
- Apos cada agente, registre:
54
-
55
- ```bash
56
- python "$CLAUDE_PROJECT_DIR/.claude/hooks/workflow-manager.py" agent-executed --agent [nome] --result approved
57
- ```
58
-
59
- ---
60
-
61
- ## PASSO 4: QUALITY GATES
62
-
63
- ```bash
64
- bun run typecheck && bun run lint && bun run test && bun run test:e2e && bun run build
65
- ```
66
-
67
- Registre cada resultado:
68
-
69
- ```bash
70
- python "$CLAUDE_PROJECT_DIR/.claude/hooks/workflow-manager.py" quality-gate --gate typecheck --passed true
71
- python "$CLAUDE_PROJECT_DIR/.claude/hooks/workflow-manager.py" quality-gate --gate lint --passed true
72
- python "$CLAUDE_PROJECT_DIR/.claude/hooks/workflow-manager.py" quality-gate --gate build --passed true
73
- ```
74
-
75
- ---
76
-
77
- ## PASSO 5: VALIDACAO FINAL
78
-
79
- ```bash
80
- python "$CLAUDE_PROJECT_DIR/.claude/hooks/workflow-manager.py" final-validation --result approved --ready-to-commit true
81
- ```
82
-
83
- ---
84
-
85
- ## PASSO 6: COMMIT (se solicitado)
86
-
87
- Apos commit bem-sucedido:
88
-
89
- ```bash
90
- python "$CLAUDE_PROJECT_DIR/.claude/hooks/workflow-manager.py" complete-task --commit-hash [HASH]
91
- ```
92
-
93
- ---
94
-
95
- ## CRITERIOS DE SUCESSO
96
-
97
- - [ ] Workflow iniciado via workflow-manager
98
- - [ ] Analyzer executado e arquivos aprovados
99
- - [ ] Agentes executados na ordem
100
- - [ ] Testes criados (unit + E2E se UI)
101
- - [ ] Quality gates passando
102
- - [ ] Final validation aprovada
1
+ # /feature - Iniciar Nova Feature
2
+
3
+ ---
4
+
5
+ command: feature
6
+ description: Inicia o fluxo completo para uma nova feature
7
+ usage: /feature [descricao da feature]
8
+
9
+ ---
10
+
11
+ ## Fluxo de Desenvolvimento
12
+
13
+ Execute na ordem (use Task tool para invocar cada agente):
14
+
15
+ | Ordem | Agente | Arquivo | Quando |
16
+ | ----- | ----------------- | ------------------------------------ | --------- |
17
+ | 1 | analyzer | `.claude/agents/analyzer.md` | Sempre |
18
+ | 2 | ui-ux-reviewer | `.claude/agents/ui-ux-reviewer.md` | Se tem UI |
19
+ | 3 | documenter | `.claude/agents/documenter.md` | Sempre |
20
+ | 4 | **[IMPLEMENTAR]** | - | - |
21
+ | 5 | tester | `.claude/agents/tester.md` | Sempre |
22
+ | 6 | security-auditor | `.claude/agents/security-auditor.md` | Sempre |
23
+ | 7 | quality-checker | `.claude/agents/quality-checker.md` | Sempre |
24
+ | 8 | final-validator | `.claude/agents/final-validator.md` | Sempre |
25
+ | 9 | commit-manager | `.claude/agents/commit-manager.md` | Sempre |
26
+
27
+ ---
28
+
29
+ ## Quality Gates
30
+
31
+ ```bash
32
+ bun run typecheck && bun run lint && bun run test && bun run test:e2e && bun run build
33
+ ```
34
+
35
+ ---
36
+
37
+ ## Critérios de Sucesso
38
+
39
+ - [ ] Analyzer executado antes da implementação
40
+ - [ ] Agentes executados na ordem
41
+ - [ ] Testes criados (unit + E2E se UI)
42
+ - [ ] Todos quality gates passaram
43
+ - [ ] Documentação atualizada
44
+ - [ ] Security audit aprovado
45
+ - [ ] Commit convencional criado
46
+
47
+ - [ ] Quality gates passando
48
+ - [ ] Final validation aprovada
@@ -1,30 +1,30 @@
1
- # Project Configuration
2
-
3
- This directory contains project-specific configuration files that agents read to adapt their behavior to your project.
4
-
5
- ## Files
6
-
7
- | File | Purpose |
8
- |------|---------|
9
- | `project-config.json` | Main project configuration (stack, structure, commands) |
10
- | `domain-mapping.json` | Maps file patterns to knowledge domains |
11
- | `quality-gates.json` | Quality check commands |
12
- | `testing-config.json` | Testing framework and conventions |
13
- | `security-rules.json` | Security audit rules |
14
-
15
- ## How Agents Use These
16
-
17
- 1. **analyzer** - Reads `project-config.json` for structure, `domain-mapping.json` for domains
18
- 2. **tester** - Reads `testing-config.json` for frameworks and conventions
19
- 3. **security-auditor** - Reads `security-rules.json` for security patterns
20
- 4. **quality-checker** - Reads `quality-gates.json` for commands
21
- 5. **domain-updater** - Reads `domain-mapping.json` for file-to-domain mapping
22
-
23
- ## Customizing for Your Project
24
-
25
- 1. Update `project-config.json` with your stack and commands
26
- 2. Update `domain-mapping.json` with your project structure
27
- 3. Update `testing-config.json` with your test conventions
28
- 4. Update `security-rules.json` with your auth framework
29
-
30
- The agents will automatically adapt to your configuration.
1
+ # Project Configuration
2
+
3
+ This directory contains project-specific configuration files that agents read to adapt their behavior to your project.
4
+
5
+ ## Files
6
+
7
+ | File | Purpose |
8
+ |------|---------|
9
+ | `project-config.json` | Main project configuration (stack, structure, commands) |
10
+ | `domain-mapping.json` | Maps file patterns to knowledge domains |
11
+ | `quality-gates.json` | Quality check commands |
12
+ | `testing-config.json` | Testing framework and conventions |
13
+ | `security-rules.json` | Security audit rules |
14
+
15
+ ## How Agents Use These
16
+
17
+ 1. **analyzer** - Reads `project-config.json` for structure, `domain-mapping.json` for domains
18
+ 2. **tester** - Reads `testing-config.json` for frameworks and conventions
19
+ 3. **security-auditor** - Reads `security-rules.json` for security patterns
20
+ 4. **quality-checker** - Reads `quality-gates.json` for commands
21
+ 5. **domain-updater** - Reads `domain-mapping.json` for file-to-domain mapping
22
+
23
+ ## Customizing for Your Project
24
+
25
+ 1. Update `project-config.json` with your stack and commands
26
+ 2. Update `domain-mapping.json` with your project structure
27
+ 3. Update `testing-config.json` with your test conventions
28
+ 4. Update `security-rules.json` with your auth framework
29
+
30
+ The agents will automatically adapt to your configuration.
@@ -1,26 +1,55 @@
1
- {
2
- "$comment": "Maps file patterns to domain names. Used by domain-updater and analyzer agents.",
3
-
4
- "domains": {
5
- "rpc-explorer": {
6
- "patterns": ["apps/rpc-explorer/*"],
7
- "description": "RPC node discovery and testing"
8
- },
9
- "rpc-proxy": {
10
- "patterns": ["apps/rpc-proxy/*"],
11
- "description": "Intelligent RPC proxy with load balancing"
12
- },
13
- "infrastructure": {
14
- "patterns": ["common/*", "docker-compose.yml", "Dockerfile*"],
15
- "description": "Shared infrastructure and configuration"
16
- },
17
- "types": {
18
- "patterns": ["types/*"],
19
- "description": "Shared TypeScript type definitions"
20
- }
21
- },
22
-
23
- "defaultDomain": "general",
24
-
25
- "domainFilesPath": ".claude/skills/codebase-knowledge/domains/"
26
- }
1
+ {
2
+ "$comment": "Maps file patterns to domain names. Configure for your project structure.",
3
+
4
+ "domains": {
5
+ "frontend": {
6
+ "patterns": [
7
+ "apps/front/*",
8
+ "apps/front/src/*",
9
+ "apps/front/src/app/*",
10
+ "apps/front/src/components/*"
11
+ ],
12
+ "description": "Frontend application"
13
+ },
14
+ "backend": {
15
+ "patterns": [
16
+ "apps/api/*",
17
+ "apps/api/src/*"
18
+ ],
19
+ "description": "Backend API services"
20
+ },
21
+ "infrastructure": {
22
+ "patterns": [
23
+ "common/*",
24
+ "common/db/*",
25
+ "common/config/*",
26
+ "common/utils/*"
27
+ ],
28
+ "description": "Shared infrastructure - logger, database, config, utilities"
29
+ },
30
+ "types": {
31
+ "patterns": [
32
+ "types/*"
33
+ ],
34
+ "description": "TypeScript type definitions"
35
+ },
36
+ "docker": {
37
+ "patterns": [
38
+ "docker/*",
39
+ "docker-compose.yml",
40
+ "apps/*/Dockerfile"
41
+ ],
42
+ "description": "Docker configuration and containerization"
43
+ },
44
+ "scripts": {
45
+ "patterns": [
46
+ "scripts/*"
47
+ ],
48
+ "description": "Utility scripts for development and deployment"
49
+ }
50
+ },
51
+
52
+ "defaultDomain": "general",
53
+
54
+ "domainFilesPath": ".claude/skills/codebase-knowledge/domains/"
55
+ }
@@ -1,53 +1,56 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$comment": "Project-specific configuration. Agents read this to adapt to your project.",
4
-
5
- "stack": {
6
- "runtime": "bun",
7
- "language": "typescript",
8
- "strictMode": true,
9
- "database": "mongodb",
10
- "orm": "mongoose",
11
- "validation": "zod",
12
- "container": "docker"
13
- },
14
-
15
- "structure": {
16
- "apps": "apps/",
17
- "shared": "common/",
18
- "types": "types/",
19
- "tests": "tests/",
20
- "docs": "docs/"
21
- },
22
-
23
- "pathAliases": {
24
- "$types/*": "./types/*",
25
- "@common/*": "./common/*",
26
- "@common": "./common/index.ts",
27
- "@db/*": "./common/db/*",
28
- "@db": "./common/db/index.ts",
29
- "@apps/*": "./apps/*"
30
- },
31
-
32
- "commands": {
33
- "typecheck": "bun run typecheck",
34
- "lint": "bun run lint",
35
- "test": "bun run test",
36
- "testE2e": "bun run test:e2e",
37
- "build": "bun run build",
38
- "dev": "bun run dev",
39
- "dockerBuild": "docker compose build",
40
- "dockerUp": "docker compose up"
41
- },
42
-
43
- "conventions": {
44
- "branchPrefix": {
45
- "feature": "feature/",
46
- "bugfix": "fix/",
47
- "refactor": "refactor/"
48
- },
49
- "commitFormat": "conventional",
50
- "typesLocation": "types/",
51
- "noTypesInSrc": true
52
- }
53
- }
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$comment": "Project-specific configuration. Agents read this to adapt to your project.",
4
+
5
+ "project": {
6
+ "name": "my-project",
7
+ "description": "Project description here",
8
+ "type": "monorepo"
9
+ },
10
+
11
+ "stack": {
12
+ "runtime": "bun",
13
+ "language": "typescript",
14
+ "strictMode": true,
15
+ "database": "mongodb",
16
+ "orm": "mongoose",
17
+ "validation": "zod",
18
+ "container": "docker"
19
+ },
20
+
21
+ "structure": {
22
+ "apps": "apps/",
23
+ "shared": "common/",
24
+ "types": "types/",
25
+ "tests": "tests/",
26
+ "docs": "docs/"
27
+ },
28
+
29
+ "pathAliases": {
30
+ "$types/*": "./types/*",
31
+ "@common/*": "./common/*",
32
+ "@common": "./common/index.ts"
33
+ },
34
+
35
+ "commands": {
36
+ "typecheck": "bun run typecheck",
37
+ "lint": "bun run lint",
38
+ "test": "bun run test",
39
+ "testE2e": "bun run test:e2e",
40
+ "build": "bun run build",
41
+ "dev": "bun run dev",
42
+ "dockerBuild": "docker compose build",
43
+ "dockerUp": "docker compose up"
44
+ },
45
+
46
+ "conventions": {
47
+ "branchPrefix": {
48
+ "feature": "feature/",
49
+ "bugfix": "fix/",
50
+ "refactor": "refactor/"
51
+ },
52
+ "commitFormat": "conventional",
53
+ "typesLocation": "types/",
54
+ "noTypesInSrc": true
55
+ }
56
+ }
@@ -1,46 +1,46 @@
1
- {
2
- "$comment": "Quality gate commands. Agents use these to run checks.",
3
-
4
- "gates": {
5
- "typecheck": {
6
- "command": "bun run typecheck",
7
- "description": "TypeScript type checking",
8
- "required": true,
9
- "order": 1
10
- },
11
- "lint": {
12
- "command": "bun run lint",
13
- "description": "ESLint code linting",
14
- "required": true,
15
- "order": 2
16
- },
17
- "unitTests": {
18
- "command": "bun run test",
19
- "description": "Unit tests with Vitest",
20
- "required": true,
21
- "order": 3
22
- },
23
- "e2eTests": {
24
- "command": "bun run test:e2e",
25
- "description": "E2E tests with Playwright",
26
- "required": false,
27
- "order": 4
28
- },
29
- "build": {
30
- "command": "bun run build",
31
- "description": "Production build",
32
- "required": true,
33
- "order": 5
34
- },
35
- "dockerBuild": {
36
- "command": "docker compose build",
37
- "description": "Docker image build",
38
- "required": false,
39
- "order": 6
40
- }
41
- },
42
-
43
- "runAll": "bun run typecheck && bun run lint && bun run test && bun run build",
44
-
45
- "skipGatesForTypes": ["config", "docs"]
46
- }
1
+ {
2
+ "$comment": "Quality gate commands. Agents use these to run checks.",
3
+
4
+ "gates": {
5
+ "typecheck": {
6
+ "command": "bun run typecheck",
7
+ "description": "TypeScript type checking",
8
+ "required": true,
9
+ "order": 1
10
+ },
11
+ "lint": {
12
+ "command": "bun run lint",
13
+ "description": "ESLint code linting",
14
+ "required": true,
15
+ "order": 2
16
+ },
17
+ "unitTests": {
18
+ "command": "bun run test",
19
+ "description": "Unit tests with Vitest",
20
+ "required": true,
21
+ "order": 3
22
+ },
23
+ "e2eTests": {
24
+ "command": "bun run test:e2e",
25
+ "description": "E2E tests with Playwright",
26
+ "required": false,
27
+ "order": 4
28
+ },
29
+ "build": {
30
+ "command": "bun run build",
31
+ "description": "Production build",
32
+ "required": true,
33
+ "order": 5
34
+ },
35
+ "dockerBuild": {
36
+ "command": "docker compose build",
37
+ "description": "Docker image build",
38
+ "required": false,
39
+ "order": 6
40
+ }
41
+ },
42
+
43
+ "runAll": "bun run typecheck && bun run lint && bun run test && bun run build",
44
+
45
+ "skipGatesForTypes": ["config", "docs"]
46
+ }
@@ -1,45 +1,45 @@
1
- {
2
- "$comment": "Security rules. Used by security-auditor agent.",
3
-
4
- "authentication": {
5
- "framework": "session-based",
6
- "userIdSource": "ctx.user._id",
7
- "protectedProcedure": "protectedProcedure",
8
- "sessionStore": "mongodb"
9
- },
10
-
11
- "validation": {
12
- "library": "zod",
13
- "requireOnAllRoutes": true
14
- },
15
-
16
- "sensitivePatterns": {
17
- "forbidden": [
18
- "input.userId",
19
- "input.user_id",
20
- "req.body.userId",
21
- "passwordHash",
22
- "password:"
23
- ],
24
- "files": ["auth/", "api/", "server/", "routers/"]
25
- },
26
-
27
- "cryptography": {
28
- "passwordHashing": "bcrypt",
29
- "minSaltRounds": 10,
30
- "tokenGeneration": "crypto.randomBytes"
31
- },
32
-
33
- "cookies": {
34
- "httpOnly": true,
35
- "secure": true,
36
- "sameSite": "strict"
37
- },
38
-
39
- "owaspChecks": {
40
- "a01_brokenAccessControl": true,
41
- "a02_cryptographicFailures": true,
42
- "a03_injection": true,
43
- "a07_authenticationFailures": true
44
- }
45
- }
1
+ {
2
+ "$comment": "Security rules. Used by security-auditor agent.",
3
+
4
+ "authentication": {
5
+ "framework": "session-based",
6
+ "userIdSource": "ctx.user._id",
7
+ "protectedProcedure": "protectedProcedure",
8
+ "sessionStore": "mongodb"
9
+ },
10
+
11
+ "validation": {
12
+ "library": "zod",
13
+ "requireOnAllRoutes": true
14
+ },
15
+
16
+ "sensitivePatterns": {
17
+ "forbidden": [
18
+ "input.userId",
19
+ "input.user_id",
20
+ "req.body.userId",
21
+ "passwordHash",
22
+ "password:"
23
+ ],
24
+ "files": ["auth/", "api/", "server/", "routers/"]
25
+ },
26
+
27
+ "cryptography": {
28
+ "passwordHashing": "bcrypt",
29
+ "minSaltRounds": 10,
30
+ "tokenGeneration": "crypto.randomBytes"
31
+ },
32
+
33
+ "cookies": {
34
+ "httpOnly": true,
35
+ "secure": true,
36
+ "sameSite": "strict"
37
+ },
38
+
39
+ "owaspChecks": {
40
+ "a01_brokenAccessControl": true,
41
+ "a02_cryptographicFailures": true,
42
+ "a03_injection": true,
43
+ "a07_authenticationFailures": true
44
+ }
45
+ }