@pathbit/agentdevkit 0.0.0-stage → 0.0.6

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 (242) hide show
  1. package/.pbai4devs/COMPATIBILIDADE.md +109 -0
  2. package/.pbai4devs/INSTRUCTIONS.md +87 -0
  3. package/.pbai4devs/README.md +53 -0
  4. package/.pbai4devs/agents/README.md +18 -0
  5. package/.pbai4devs/agents/revisor/AGENT.md +16 -0
  6. package/.pbai4devs/agents/revisor/antigravity.yaml +8 -0
  7. package/.pbai4devs/agents/revisor/claude.yaml +5 -0
  8. package/.pbai4devs/agents/revisor/cursor.yaml +5 -0
  9. package/.pbai4devs/agents/revisor/gemini.yaml +6 -0
  10. package/.pbai4devs/agents/revisor/github.yaml +5 -0
  11. package/.pbai4devs/agents/revisor/kimi-code.yaml +5 -0
  12. package/.pbai4devs/agents/revisor/mimocode.yaml +10 -0
  13. package/.pbai4devs/agents/revisor/opencode.yaml +7 -0
  14. package/.pbai4devs/agents/revisor/zcode.yaml +5 -0
  15. package/.pbai4devs/commands/README.md +30 -0
  16. package/.pbai4devs/commands/atualizar-ferramentas/COMMAND.md +17 -0
  17. package/.pbai4devs/commands/diagnosticar/COMMAND.md +18 -0
  18. package/.pbai4devs/commands/instalar-ferramentas/COMMAND.md +21 -0
  19. package/.pbai4devs/commands/preparar-dev/COMMAND.md +14 -0
  20. package/.pbai4devs/commands/proximos-passos/COMMAND.md +9 -0
  21. package/.pbai4devs/commands/revisar-entrega/COMMAND.md +29 -0
  22. package/.pbai4devs/commands/sincronizar/COMMAND.md +20 -0
  23. package/.pbai4devs/commands/status-roadmap/COMMAND.md +12 -0
  24. package/.pbai4devs/commands/testar-navegador/COMMAND.md +16 -0
  25. package/.pbai4devs/commands/verificar-agentes/COMMAND.md +19 -0
  26. package/.pbai4devs/estado/README.md +12 -0
  27. package/.pbai4devs/external-skills/CATALOG.json +121 -0
  28. package/.pbai4devs/external-skills/README.md +48 -0
  29. package/.pbai4devs/rules/README.md +18 -0
  30. package/.pbai4devs/rules/ambiente-local/RULE.md +33 -0
  31. package/.pbai4devs/rules/ambiente-local/cursor.yaml +4 -0
  32. package/.pbai4devs/rules/documentacao/RULE.md +11 -0
  33. package/.pbai4devs/rules/documentacao/cursor.yaml +4 -0
  34. package/.pbai4devs/rules/estrutura/RULE.md +33 -0
  35. package/.pbai4devs/rules/estrutura/cursor.yaml +4 -0
  36. package/.pbai4devs/rules/git/RULE.md +18 -0
  37. package/.pbai4devs/rules/git/cursor.yaml +4 -0
  38. package/.pbai4devs/rules/proximos-passos/RULE.md +14 -0
  39. package/.pbai4devs/rules/qualidade/RULE.md +32 -0
  40. package/.pbai4devs/rules/qualidade/cursor.yaml +4 -0
  41. package/.pbai4devs/scripts/README.md +69 -0
  42. package/.pbai4devs/scripts/diagnosticar-ambiente/SCRIPT.mjs +41 -0
  43. package/.pbai4devs/scripts/diagnosticar-ambiente/tests/TEST.mjs +30 -0
  44. package/.pbai4devs/scripts/executar-script/README.md +28 -0
  45. package/.pbai4devs/scripts/executar-script/SCRIPT.mjs +78 -0
  46. package/.pbai4devs/scripts/executar-script/tests/TEST.mjs +122 -0
  47. package/.pbai4devs/scripts/gerenciar-skills-externas/README.md +31 -0
  48. package/.pbai4devs/scripts/gerenciar-skills-externas/SCRIPT.mjs +182 -0
  49. package/.pbai4devs/scripts/gerenciar-skills-externas/tests/TEST.mjs +134 -0
  50. package/.pbai4devs/scripts/inspecionar-projeto/SCRIPT.mjs +190 -0
  51. package/.pbai4devs/scripts/inspecionar-projeto/tests/TEST.mjs +161 -0
  52. package/.pbai4devs/scripts/lib/README.md +9 -0
  53. package/.pbai4devs/scripts/lib/adapters.mjs +135 -0
  54. package/.pbai4devs/scripts/lib/catalog.mjs +170 -0
  55. package/.pbai4devs/scripts/lib/gitignore.mjs +348 -0
  56. package/.pbai4devs/scripts/lib/npm.mjs +17 -0
  57. package/.pbai4devs/scripts/lib/resource-path.mjs +20 -0
  58. package/.pbai4devs/scripts/lib/runtime.mjs +28 -0
  59. package/.pbai4devs/scripts/lib/script-config.mjs +8 -0
  60. package/.pbai4devs/scripts/preparar-ferramentas/BOOTSTRAP.md +34 -0
  61. package/.pbai4devs/scripts/preparar-ferramentas/BOOTSTRAP.mjs +189 -0
  62. package/.pbai4devs/scripts/preparar-ferramentas/README.md +71 -0
  63. package/.pbai4devs/scripts/preparar-ferramentas/SCRIPT.mjs +455 -0
  64. package/.pbai4devs/scripts/preparar-ferramentas/tests/FIXTURE.html +20 -0
  65. package/.pbai4devs/scripts/preparar-ferramentas/tests/SMOKE_BROWSER.mjs +55 -0
  66. package/.pbai4devs/scripts/preparar-ferramentas/tests/SMOKE_DESKTOP.mjs +61 -0
  67. package/.pbai4devs/scripts/preparar-ferramentas/tests/SMOKE_VERCEL.mjs +192 -0
  68. package/.pbai4devs/scripts/preparar-ferramentas/tests/TEST.mjs +552 -0
  69. package/.pbai4devs/scripts/preparar-ferramentas/tests/bootstrap.test.mjs +94 -0
  70. package/.pbai4devs/scripts/preparar-ferramentas/tests/fixtures-vercel/just-bash/input.txt +2 -0
  71. package/.pbai4devs/scripts/preparar-ferramentas/tests/fixtures-vercel/just-bash-overlay/input.txt +1 -0
  72. package/.pbai4devs/scripts/preparar-ferramentas/tests/fixtures-vercel/skills/agentdevkit-smoke/SKILL.md +8 -0
  73. package/.pbai4devs/scripts/preparar-ferramentas/tests/fixtures-vercel/webreel/index.html +6 -0
  74. package/.pbai4devs/scripts/preparar-ferramentas/tests/fixtures-vercel/webreel/webreel.config.json +10 -0
  75. package/.pbai4devs/scripts/revisar-entrega/README.md +36 -0
  76. package/.pbai4devs/scripts/revisar-entrega/SCRIPT.mjs +249 -0
  77. package/.pbai4devs/scripts/revisar-entrega/tests/TEST.mjs +249 -0
  78. package/.pbai4devs/scripts/sincronizar-agentes/README.md +41 -0
  79. package/.pbai4devs/scripts/sincronizar-agentes/SCRIPT.mjs +473 -0
  80. package/.pbai4devs/scripts/sincronizar-agentes/tests/LOCAL_IGNORE.mjs +290 -0
  81. package/.pbai4devs/scripts/sincronizar-agentes/tests/TEST.mjs +869 -0
  82. package/.pbai4devs/scripts/testar-infraestrutura/SCRIPT.mjs +39 -0
  83. package/.pbai4devs/scripts/testar-infraestrutura/tests/TEST.mjs +29 -0
  84. package/.pbai4devs/scripts/testar-maturidade/README.md +54 -0
  85. package/.pbai4devs/scripts/testar-maturidade/SCRIPT.mjs +477 -0
  86. package/.pbai4devs/scripts/testar-maturidade/assets/calculator.mjs +1 -0
  87. package/.pbai4devs/scripts/testar-maturidade/assets/calculator.test.mjs.template +8 -0
  88. package/.pbai4devs/scripts/testar-maturidade/assets/http-api.test.mjs.template +28 -0
  89. package/.pbai4devs/scripts/testar-maturidade/assets/server.mjs +34 -0
  90. package/.pbai4devs/scripts/testar-maturidade/tests/TEST.mjs +305 -0
  91. package/.pbai4devs/scripts/testar-navegador/REFERENCE.md +49 -0
  92. package/.pbai4devs/scripts/testar-navegador/SCRIPT.conf +1 -0
  93. package/.pbai4devs/scripts/testar-navegador/SCRIPT.js +64 -0
  94. package/.pbai4devs/scripts/testar-navegador/tests/FAIL.js +8 -0
  95. package/.pbai4devs/scripts/testar-navegador/tests/SUCCESS.js +13 -0
  96. package/.pbai4devs/scripts/verificar-recursos/README.md +25 -0
  97. package/.pbai4devs/scripts/verificar-recursos/SCRIPT.mjs +209 -0
  98. package/.pbai4devs/scripts/verificar-recursos/tests/TEST.mjs +310 -0
  99. package/.pbai4devs/scripts/verificar-recursos/tests/ambiente-local.mjs +80 -0
  100. package/.pbai4devs/skills/README.md +24 -0
  101. package/.pbai4devs/skills/git/git-branch/SKILL.md +11 -0
  102. package/.pbai4devs/skills/git/git-commit/SKILL.md +16 -0
  103. package/.pbai4devs/skills/git/git-diff/SKILL.md +9 -0
  104. package/.pbai4devs/skills/git/git-fetch/SKILL.md +10 -0
  105. package/.pbai4devs/skills/git/git-log/SKILL.md +9 -0
  106. package/.pbai4devs/skills/git/git-merge/SKILL.md +13 -0
  107. package/.pbai4devs/skills/git/git-pull/SKILL.md +12 -0
  108. package/.pbai4devs/skills/git/git-push/SKILL.md +12 -0
  109. package/.pbai4devs/skills/git/git-status/SKILL.md +9 -0
  110. package/.pbai4devs/skills/git/git-worktree/SKILL.md +10 -0
  111. package/.pbai4devs/skills/produto/criar-design-doc/SKILL.md +37 -0
  112. package/.pbai4devs/skills/produto/criar-prd/SKILL.md +35 -0
  113. package/.pbai4devs/skills/produto/criar-ux-ui/SKILL.md +34 -0
  114. package/.pbai4devs/skills/projeto/atualizar-documentacao/SKILL.md +26 -0
  115. package/.pbai4devs/skills/projeto/configurar-projeto/SKILL.md +62 -0
  116. package/.pbai4devs/skills/projeto/criar-agente/SKILL.md +20 -0
  117. package/.pbai4devs/skills/projeto/criar-comando/SKILL.md +25 -0
  118. package/.pbai4devs/skills/projeto/criar-recurso/SKILL.md +41 -0
  119. package/.pbai4devs/skills/projeto/criar-regra/SKILL.md +19 -0
  120. package/.pbai4devs/skills/projeto/criar-skill/SKILL.md +22 -0
  121. package/.pbai4devs/skills/projeto/executar-script/SKILL.md +29 -0
  122. package/.pbai4devs/skills/projeto/preparar-dev/SKILL.md +45 -0
  123. package/.pbai4devs/skills/projeto/preparar-ferramentas/SKILL.md +56 -0
  124. package/.pbai4devs/skills/projeto/proximos-passos/SKILL.md +23 -0
  125. package/.pbai4devs/skills/projeto/sincronizar-agentes/SKILL.md +42 -0
  126. package/.pbai4devs/skills/projeto/usar-skills-externas/SKILL.md +28 -0
  127. package/.pbai4devs/skills/projeto/verificar-trabalho/SKILL.md +45 -0
  128. package/.pbai4devs/skills/specs/criar-spec/SKILL.md +33 -0
  129. package/.pbai4devs/skills/specs/gerenciar-roadmap/SKILL.md +26 -0
  130. package/.pbai4devs/skills/specs/implementar-spec/SKILL.md +48 -0
  131. package/.pbai4devs/templates/README.md +65 -0
  132. package/.pbai4devs/templates/adr/TEMPLATE.md +21 -0
  133. package/.pbai4devs/templates/ambiente-local/Makefile.template +48 -0
  134. package/.pbai4devs/templates/ambiente-local/TEMPLATE.md +48 -0
  135. package/.pbai4devs/templates/ambiente-local/compose.local.yml.template +16 -0
  136. package/.pbai4devs/templates/ambiente-local/dockerignore.template +28 -0
  137. package/.pbai4devs/templates/changelog/TEMPLATE.md +17 -0
  138. package/.pbai4devs/templates/claude/TEMPLATE.md +8 -0
  139. package/.pbai4devs/templates/clients/ADAPTERS.json +306 -0
  140. package/.pbai4devs/templates/clients/TEMPLATE.md +12 -0
  141. package/.pbai4devs/templates/comando/TEMPLATE.md +15 -0
  142. package/.pbai4devs/templates/configuracao/TEMPLATE.md +46 -0
  143. package/.pbai4devs/templates/configuracao-raiz/TEMPLATE.md +22 -0
  144. package/.pbai4devs/templates/configuracao-raiz/editorconfig.template +21 -0
  145. package/.pbai4devs/templates/configuracao-raiz/env.example.template +3 -0
  146. package/.pbai4devs/templates/configuracao-raiz/gitattributes.template +6 -0
  147. package/.pbai4devs/templates/contribuicao/TEMPLATE.md +23 -0
  148. package/.pbai4devs/templates/design/TEMPLATE.md +30 -0
  149. package/.pbai4devs/templates/entrypoints/AGENTS.md +19 -0
  150. package/.pbai4devs/templates/entrypoints/CLAUDE.md +7 -0
  151. package/.pbai4devs/templates/entrypoints/GEMINI.md +7 -0
  152. package/.pbai4devs/templates/entrypoints/TEMPLATE.md +12 -0
  153. package/.pbai4devs/templates/gitignore/TEMPLATE.md +42 -0
  154. package/.pbai4devs/templates/gitignore/agents.ignore +45 -0
  155. package/.pbai4devs/templates/gitignore/clients.json +20 -0
  156. package/.pbai4devs/templates/gitignore/local.ignore +10 -0
  157. package/.pbai4devs/templates/gitignore/shared.ignore +60 -0
  158. package/.pbai4devs/templates/instrucoes-agentes/TEMPLATE.md +25 -0
  159. package/.pbai4devs/templates/plano-implementacao/TEMPLATE.md +27 -0
  160. package/.pbai4devs/templates/prd/TEMPLATE.md +30 -0
  161. package/.pbai4devs/templates/readme-pasta/TEMPLATE.md +16 -0
  162. package/.pbai4devs/templates/readme-projeto/TEMPLATE.md +34 -0
  163. package/.pbai4devs/templates/release/TEMPLATE.md +23 -0
  164. package/.pbai4devs/templates/revisao-entrega/TEMPLATE.md +41 -0
  165. package/.pbai4devs/templates/roadmap/TEMPLATE.md +18 -0
  166. package/.pbai4devs/templates/seguranca/TEMPLATE.md +22 -0
  167. package/.pbai4devs/templates/spec/TEMPLATE.md +61 -0
  168. package/.pbai4devs/templates/tasks/TEMPLATE.md +20 -0
  169. package/.pbai4devs/templates/ux-ui/TEMPLATE.md +26 -0
  170. package/.pbai4devs/tools/README.md +87 -0
  171. package/.pbai4devs/tools/agent-browser/README.md +26 -0
  172. package/.pbai4devs/tools/agent-browser/SCRIPT.mjs +5 -0
  173. package/.pbai4devs/tools/agent-browser/TOOL.json +33 -0
  174. package/.pbai4devs/tools/agent-desktop/README.md +26 -0
  175. package/.pbai4devs/tools/agent-desktop/SCRIPT.mjs +5 -0
  176. package/.pbai4devs/tools/agent-desktop/TOOL.json +30 -0
  177. package/.pbai4devs/tools/just-bash/README.md +23 -0
  178. package/.pbai4devs/tools/just-bash/SCRIPT.mjs +5 -0
  179. package/.pbai4devs/tools/just-bash/TOOL.json +27 -0
  180. package/.pbai4devs/tools/markdownlint-cli2/README.md +18 -0
  181. package/.pbai4devs/tools/markdownlint-cli2/SCRIPT.mjs +5 -0
  182. package/.pbai4devs/tools/markdownlint-cli2/TOOL.json +28 -0
  183. package/.pbai4devs/tools/opensrc/README.md +25 -0
  184. package/.pbai4devs/tools/opensrc/SCRIPT.mjs +5 -0
  185. package/.pbai4devs/tools/opensrc/TOOL.json +29 -0
  186. package/.pbai4devs/tools/portless/README.md +21 -0
  187. package/.pbai4devs/tools/portless/SCRIPT.mjs +5 -0
  188. package/.pbai4devs/tools/portless/TOOL.json +30 -0
  189. package/.pbai4devs/tools/skills/README.md +24 -0
  190. package/.pbai4devs/tools/skills/SCRIPT.mjs +5 -0
  191. package/.pbai4devs/tools/skills/TOOL.json +33 -0
  192. package/.pbai4devs/tools/webreel/README.md +23 -0
  193. package/.pbai4devs/tools/webreel/SCRIPT.mjs +5 -0
  194. package/.pbai4devs/tools/webreel/TOOL.json +25 -0
  195. package/CHANGELOG.md +65 -0
  196. package/CONTRIBUTING.md +73 -0
  197. package/LICENSE +21 -0
  198. package/README.en.md +89 -0
  199. package/README.es.md +91 -0
  200. package/README.md +94 -2
  201. package/bin/README.md +8 -0
  202. package/bin/agentdevkit.mjs +35 -0
  203. package/docs/README.md +81 -0
  204. package/docs/guides/README.md +14 -0
  205. package/docs/guides/cli.md +81 -0
  206. package/docs/guides/installation.md +86 -0
  207. package/docs/guides/resources.md +121 -0
  208. package/docs/guides/tools-and-testing.md +85 -0
  209. package/docs/guides/troubleshooting.md +151 -0
  210. package/docs/guides/workflow.md +130 -0
  211. package/docs/maintainers/README.md +12 -0
  212. package/docs/maintainers/community.md +49 -0
  213. package/docs/maintainers/development.md +54 -0
  214. package/docs/maintainers/maintenance.md +104 -0
  215. package/docs/maintainers/packages.md +87 -0
  216. package/docs/product/README.md +12 -0
  217. package/docs/product/design.md +104 -0
  218. package/docs/product/prd.md +70 -0
  219. package/docs/product/roadmap.md +38 -0
  220. package/docs/product/ux-ui.md +42 -0
  221. package/docs/specs/README.md +21 -0
  222. package/docs/specs/github-packages/SPEC.md +45 -0
  223. package/docs/specs/v0.0.1/README.md +10 -0
  224. package/docs/specs/v0.0.1/SPEC.md +57 -0
  225. package/docs/specs/v0.0.2/README.md +10 -0
  226. package/docs/specs/v0.0.2/SPEC.md +67 -0
  227. package/docs/specs/v0.0.3/README.md +10 -0
  228. package/docs/specs/v0.0.3/SPEC.md +64 -0
  229. package/docs/specs/v0.0.4/README.md +10 -0
  230. package/docs/specs/v0.0.4/SPEC.md +53 -0
  231. package/docs/specs/v0.0.5/README.md +9 -0
  232. package/docs/specs/v0.0.5/SPEC.md +42 -0
  233. package/docs/specs/v0.0.6/README.md +10 -0
  234. package/docs/specs/v0.0.6/SPEC.md +77 -0
  235. package/package.json +67 -4
  236. package/src/README.md +16 -0
  237. package/src/adapters/index.mjs +1 -0
  238. package/src/cli.mjs +162 -0
  239. package/src/config.mjs +14 -0
  240. package/src/i18n.mjs +42 -0
  241. package/src/install.mjs +373 -0
  242. package/src/next.mjs +79 -0
@@ -0,0 +1,306 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "entrypoints": [
4
+ "AGENTS.md"
5
+ ],
6
+ "adapters": [
7
+ {
8
+ "id": "antigravity",
9
+ "name": "Antigravity",
10
+ "root": ".agents",
11
+ "formats": {
12
+ "skills": "agrupado",
13
+ "agents": "plano",
14
+ "rules": "agrupado"
15
+ },
16
+ "discovery": "antigravity",
17
+ "agentMetadata": "antigravity.yaml",
18
+ "reason": "Grupos são registrados em manifests nativos; o scan padrão alcança apenas um nível.",
19
+ "sources": [
20
+ "https://antigravity.google/docs/customization-discovery"
21
+ ],
22
+ "aliases": [],
23
+ "requires": [],
24
+ "extraRoots": [],
25
+ "entrypoints": [
26
+ "GEMINI.md"
27
+ ]
28
+ },
29
+ {
30
+ "id": "antigravity-legacy",
31
+ "name": "Antigravity (legado)",
32
+ "root": ".agent",
33
+ "formats": {
34
+ "skills": "agrupado",
35
+ "agents": "plano",
36
+ "rules": "agrupado"
37
+ },
38
+ "agentMetadata": "antigravity.yaml",
39
+ "reason": "Alias legado; a descoberta agrupada é registrada pelo cliente principal .agents.",
40
+ "sources": [
41
+ "https://antigravity.google/docs/customization-discovery"
42
+ ],
43
+ "aliases": [],
44
+ "requires": [
45
+ "antigravity"
46
+ ],
47
+ "extraRoots": [],
48
+ "entrypoints": [
49
+ "GEMINI.md"
50
+ ]
51
+ },
52
+ {
53
+ "id": "claude",
54
+ "name": "Claude Code",
55
+ "root": ".claude",
56
+ "formats": {
57
+ "skills": "plano",
58
+ "agents": "plano",
59
+ "commands": "arquivo"
60
+ },
61
+ "agentMetadata": "claude.yaml",
62
+ "reason": "Skills e agentes usam o nível documentado; comandos e regras preservam grupos. Monorepos não equivalem a grupos dentro de skills/.",
63
+ "sources": [
64
+ "https://code.claude.com/docs/en/skills",
65
+ "https://code.claude.com/docs/en/sub-agents",
66
+ "https://code.claude.com/docs/en/memory"
67
+ ],
68
+ "aliases": [
69
+ "claude-code"
70
+ ],
71
+ "requires": [],
72
+ "extraRoots": [],
73
+ "entrypoints": [
74
+ "CLAUDE.md"
75
+ ]
76
+ },
77
+ {
78
+ "id": "codex",
79
+ "name": "Codex",
80
+ "root": ".codex",
81
+ "formats": {
82
+ "skills": "agrupado"
83
+ },
84
+ "reason": "Skills agrupadas; a entrada nativa de projeto é .agents/skills. Outros recursos em .codex são referências, não registros de agentes.",
85
+ "sources": [
86
+ "https://learn.chatgpt.com/docs/build-skills",
87
+ "https://github.com/openai/codex/blob/392ced7d3a9160fd35d40c606359869215f50522/codex-rs/ext/skills/src/loader/host.rs"
88
+ ],
89
+ "aliases": [],
90
+ "requires": [
91
+ "antigravity"
92
+ ],
93
+ "extraRoots": [],
94
+ "entrypoints": []
95
+ },
96
+ {
97
+ "id": "cursor",
98
+ "name": "Cursor",
99
+ "root": ".cursor",
100
+ "formats": {
101
+ "skills": "agrupado",
102
+ "agents": "plano",
103
+ "commands": "plano",
104
+ "rules": "mdc"
105
+ },
106
+ "agentMetadata": "cursor.yaml",
107
+ "ruleMetadata": "cursor.yaml",
108
+ "reason": "Skills e regras aceitam grupos. Agentes e comandos mantêm o formato direto documentado; recursão desses dois tipos não foi confirmada.",
109
+ "sources": [
110
+ "https://cursor.com/docs/skills",
111
+ "https://cursor.com/docs/subagents",
112
+ "https://prod.cursor.com/help/customization/rules",
113
+ "https://cursor.com/docs/customize-cursor"
114
+ ],
115
+ "aliases": [],
116
+ "requires": [],
117
+ "extraRoots": [],
118
+ "entrypoints": []
119
+ },
120
+ {
121
+ "id": "copilot",
122
+ "name": "GitHub Copilot / VS Code",
123
+ "root": ".github",
124
+ "formats": {
125
+ "skills": "plano",
126
+ "agents": "agente",
127
+ "commands": "prompt",
128
+ "rules": "instrucoes"
129
+ },
130
+ "agentMetadata": "github.yaml",
131
+ "reason": "O scanner CLI/SDK de skills usa subpastas imediatas. Instruções preservam grupos; prompts .prompt.md atendem ao harness Local, não substituem skills Copilot.",
132
+ "sources": [
133
+ "https://docs.github.com/en/copilot/how-tos/copilot-sdk/features/skills",
134
+ "https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions",
135
+ "https://code.visualstudio.com/docs/agent-customization/custom-agents",
136
+ "https://code.visualstudio.com/docs/agent-customization/prompt-files"
137
+ ],
138
+ "aliases": [
139
+ "vscode"
140
+ ],
141
+ "requires": [],
142
+ "extraRoots": [
143
+ ".vscode"
144
+ ],
145
+ "entrypoints": []
146
+ },
147
+ {
148
+ "id": "opencode",
149
+ "name": "OpenCode",
150
+ "root": ".opencode",
151
+ "formats": {
152
+ "skills": "agrupado",
153
+ "agents": "arquivo",
154
+ "commands": "arquivo"
155
+ },
156
+ "agentMetadata": "opencode.yaml",
157
+ "reason": "OpenCode V2 busca SKILL.md em grupos até seis níveis; agentes e comandos aceitam caminhos aninhados. rules/ contém referências, não descoberta nativa.",
158
+ "sources": [
159
+ "https://opencode.ai/docs/skills",
160
+ "https://opencode.ai/docs/agents",
161
+ "https://opencode.ai/docs/commands"
162
+ ],
163
+ "aliases": [],
164
+ "requires": [],
165
+ "extraRoots": [],
166
+ "entrypoints": []
167
+ },
168
+ {
169
+ "id": "gemini",
170
+ "name": "Gemini CLI",
171
+ "root": ".gemini",
172
+ "formats": {
173
+ "skills": "plano",
174
+ "agents": "plano",
175
+ "commands": "arquivo"
176
+ },
177
+ "agentMetadata": "gemini.yaml",
178
+ "reason": "Skills usam SKILL.md ou */SKILL.md e agentes usam *.md direto. Comandos TOML são recursivos; rules/ contém referências.",
179
+ "sources": [
180
+ "https://geminicli.com/docs/cli/skills/",
181
+ "https://geminicli.com/docs/core/subagents/",
182
+ "https://geminicli.com/docs/cli/custom-commands/",
183
+ "https://github.com/google-gemini/gemini-cli/blob/be6b6d8ff200c0cda543337c3f70b17c86337d49/packages/core/src/skills/skillLoader.ts"
184
+ ],
185
+ "aliases": [],
186
+ "requires": [],
187
+ "extraRoots": [],
188
+ "entrypoints": [
189
+ "GEMINI.md"
190
+ ]
191
+ },
192
+ {
193
+ "id": "zcode",
194
+ "name": "ZCode",
195
+ "root": ".zcode",
196
+ "formats": {
197
+ "skills": "plano",
198
+ "commands": "plano"
199
+ },
200
+ "reason": "O layout documentado de skills é plano; plugins ignoram grupos. Subagentes de projeto não são confirmados, portanto permanecem referências agrupadas.",
201
+ "sources": [
202
+ "https://zcode.z.ai/en/docs/skill",
203
+ "https://zcode.z.ai/en/docs/commands",
204
+ "https://zcode.z.ai/en/docs/subagents"
205
+ ],
206
+ "aliases": [],
207
+ "requires": [],
208
+ "extraRoots": [],
209
+ "entrypoints": []
210
+ },
211
+ {
212
+ "id": "kimi",
213
+ "name": "Kimi Code",
214
+ "root": ".kimi-code",
215
+ "formats": {
216
+ "skills": "agrupado",
217
+ "agents": "plano"
218
+ },
219
+ "agentMetadata": "kimi-code.yaml",
220
+ "reason": "O scanner atual percorre agrupadores sem SKILL.md. Comandos precisam de plugin configurado; outros apontamentos não prometem descoberta nativa.",
221
+ "sources": [
222
+ "https://moonshotai.github.io/kimi-code/en/customization/skills",
223
+ "https://github.com/MoonshotAI/kimi-code/blob/482936afceaec4d513aa28f7b7e6b461e35e105f/packages/agent-core-v2/src/features/skill/catalog/fileSkillDiscovery.ts",
224
+ "https://moonshotai.github.io/kimi-code/en/customization/plugins.html"
225
+ ],
226
+ "aliases": [
227
+ "kimi-code"
228
+ ],
229
+ "requires": [],
230
+ "extraRoots": [],
231
+ "entrypoints": []
232
+ },
233
+ {
234
+ "id": "kimi-legacy",
235
+ "name": "Kimi (legado)",
236
+ "root": ".kimi",
237
+ "formats": {
238
+ "skills": "plano"
239
+ },
240
+ "reason": "Compatibilidade com instalações legadas; o cliente atual usa .kimi-code e .agents.",
241
+ "sources": [
242
+ "https://moonshotai.github.io/kimi-code/en/customization/skills"
243
+ ],
244
+ "aliases": [],
245
+ "requires": [],
246
+ "extraRoots": [],
247
+ "entrypoints": []
248
+ },
249
+ {
250
+ "id": "minimax",
251
+ "name": "MiniMax",
252
+ "root": ".minimax",
253
+ "formats": {
254
+ "skills": "plano"
255
+ },
256
+ "reason": "O scanner enumera filhos diretos da raiz e lê <nome>/SKILL.md. Agentes, comandos e regras do projeto permanecem referências.",
257
+ "sources": [
258
+ "https://github.com/MiniMax-AI/minimax-code/blob/3c21163c85a9684030cb147bfef48c6284fa3c46/packages/agent-modules/skills/src/registry.ts",
259
+ "https://github.com/MiniMax-AI/minimax-code/blob/3c21163c85a9684030cb147bfef48c6284fa3c46/packages/local-runtime/src/skills/roots.ts"
260
+ ],
261
+ "aliases": [],
262
+ "requires": [],
263
+ "extraRoots": [],
264
+ "entrypoints": []
265
+ },
266
+ {
267
+ "id": "mimo",
268
+ "name": "MiMo",
269
+ "root": ".mimocode",
270
+ "formats": {
271
+ "skills": "agrupado",
272
+ "agents": "plano",
273
+ "commands": "plano"
274
+ },
275
+ "agentMetadata": "mimocode.yaml",
276
+ "reason": "Skills usam **/SKILL.md. Agentes e comandos mantêm o nível documentado; rules/ contém referências.",
277
+ "sources": [
278
+ "https://mimo.xiaomi.com/mimocode/skills",
279
+ "https://mimo.xiaomi.com/mimocode/agents",
280
+ "https://mimo.xiaomi.com/mimocode/commands"
281
+ ],
282
+ "aliases": [
283
+ "xiaomi"
284
+ ],
285
+ "requires": [],
286
+ "extraRoots": [],
287
+ "entrypoints": []
288
+ },
289
+ {
290
+ "id": "deepseek",
291
+ "name": "DeepSeek",
292
+ "root": ".dsh",
293
+ "formats": {
294
+ "skills": "plano"
295
+ },
296
+ "reason": "O provider oficial descobre apenas <nome>/SKILL.md ou <nome>.md direto e exclui árvores aninhadas. Outros tipos são referências.",
297
+ "sources": [
298
+ "https://github.com/deepseek-ai/deepseek-harness/blob/e8f7b93a344964de3dca1ace9e72b6e4d6de87cb/packages/skill/skill-filesystem/README.md"
299
+ ],
300
+ "aliases": [],
301
+ "requires": [],
302
+ "extraRoots": [],
303
+ "entrypoints": []
304
+ }
305
+ ]
306
+ }
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: Política declarativa de clientes do AgentDevKit.
3
+ ---
4
+
5
+ # Clientes
6
+
7
+ [ADAPTERS.json](ADAPTERS.json) define IDs, aliases, formatos, dependências,
8
+ entradas e fontes oficiais dos clientes. O helper compartilhado valida esses
9
+ dados antes de gerar qualquer arquivo.
10
+
11
+ Edite esta origem ao atualizar a compatibilidade; o pacote e a sincronização
12
+ consomem a mesma política. Não adicione instruções duplicadas nos destinos.
@@ -0,0 +1,15 @@
1
+ ---
2
+ description: Modelo conciso de um comando como caso de uso.
3
+ status: modelo
4
+ ---
5
+
6
+ # Nome do comando
7
+
8
+ Entrada: argumentos, valores padrão e o que perguntar quando faltar informação.
9
+ Pré-requisitos: documentos, runtimes ou ferramentas necessários.
10
+
11
+ Indique a skill responsável e os scripts ou ferramentas existentes, com links.
12
+ Especifique a ordem, argumentos e efeitos. Use `executar-script` para selecionar
13
+ scripts `.mjs` em Node.js 24+; referencie entradas e saídas sem copiar código.
14
+
15
+ Saída: resultado verificável, destino dos artefatos e tratamento das falhas.
@@ -0,0 +1,46 @@
1
+ ---
2
+ description: Registro da preparação e configuração do projeto.
3
+ preparacao: pendente
4
+ configuracao_tecnica: pendente
5
+ ambiente_local:
6
+ compose: infra/compose/compose.local.yml
7
+ porta: null
8
+ host: null
9
+ ferramentas: .pbai4devs/tools/
10
+ documentos:
11
+ readme: null
12
+ contribuicao: null
13
+ changelog: null
14
+ seguranca: null
15
+ adrs: null
16
+ prd: null
17
+ ux_ui: null
18
+ design: null
19
+ roadmap: null
20
+ releases: null
21
+ specs: null
22
+ tarefas: null
23
+ ---
24
+
25
+ # Configuração do projeto
26
+
27
+ ## Preparação
28
+
29
+ - Evidências e pendências: a definir.
30
+ - README da raiz e entradas dos agentes: a conferir; descreva a fase atual.
31
+
32
+ ## Configuração técnica
33
+
34
+ - SO/arquitetura, versões e ferramentas obtidas: a definir.
35
+ - Serviços, imagens/versões, portas e volumes: a definir.
36
+ - Estrutura obrigatória e comandos Makefile: a conferir pelo modelo de ambiente.
37
+ - Build, saúde, testes e prova funcional: a definir.
38
+ - Evidências e pendências: a definir.
39
+
40
+ ## Manutenção da documentação
41
+
42
+ Registre os caminhos dos documentos criados na fase apropriada. README e
43
+ configurações acompanham o projeto; produto/design precedem specs. Exemplos
44
+ de ambiente, contribuição, operação e segurança refletem contratos existentes.
45
+ Artefatos ainda não aplicáveis ficam pendentes ou justificados, sem conteúdo
46
+ de produto inventado durante a preparação.
@@ -0,0 +1,22 @@
1
+ ---
2
+ description: Modelos dos arquivos de configuração compartilhados da raiz.
3
+ status: modelo
4
+ ---
5
+
6
+ # Configuração da raiz
7
+
8
+ Copie apenas na fase de configuração e preserve decisões existentes:
9
+
10
+ | Modelo | Destino | Ajustar quando |
11
+ | --- | --- | --- |
12
+ | [EditorConfig][editor] | `.editorconfig` | Formatação mudar. |
13
+ | [Atributos Git][atributos] | `.gitattributes` | Texto/binário mudar. |
14
+ | [Ambiente](env.example.template) | `.env.example` | Configuração mudar. |
15
+
16
+ Use o [gitignore](../gitignore/TEMPLATE.md) e o
17
+ [ambiente local](../ambiente-local/TEMPLATE.md) para os demais arquivos.
18
+ Versione exemplos sem credenciais; documente variáveis, obrigatoriedade e
19
+ valores padrão reais. Teste que o setup funciona a partir do exemplo.
20
+
21
+ [editor]: editorconfig.template
22
+ [atributos]: gitattributes.template
@@ -0,0 +1,21 @@
1
+ # EditorConfig is awesome: https://EditorConfig.org
2
+
3
+ # top-most EditorConfig file
4
+ root = true
5
+
6
+ [*]
7
+ indent_style = space
8
+ indent_size = 4
9
+ end_of_line = lf
10
+ charset = utf-8
11
+ trim_trailing_whitespace = true
12
+ insert_final_newline = true
13
+
14
+ [Makefile]
15
+ indent_style = tab
16
+
17
+ [*.{bat,cmd}]
18
+ end_of_line = crlf
19
+
20
+ [*.md]
21
+ trim_trailing_whitespace = false
@@ -0,0 +1,3 @@
1
+ # Exemplo versionado: somente variáveis confirmadas, sem credenciais reais.
2
+ # Documente finalidade, obrigatoriedade e padrão antes de acrescentar uma chave.
3
+ # VARIAVEL_CONFIRMADA=
@@ -0,0 +1,6 @@
1
+ # Normaliza arquivos de texto e preserva arquivos binários detectados pelo Git.
2
+ * text=auto eol=lf
3
+
4
+ # Scripts do Windows usam CRLF no checkout.
5
+ *.bat text eol=crlf
6
+ *.cmd text eol=crlf
@@ -0,0 +1,23 @@
1
+ ---
2
+ description: Fluxo de contribuição com comandos e regras verificáveis.
3
+ status: modelo
4
+ ---
5
+
6
+ # Contribuir
7
+
8
+ ## Preparar o ambiente
9
+
10
+ [Pré-requisitos e comandos de setup já definidos e verificados.]
11
+
12
+ ## Fazer uma alteração
13
+
14
+ [Fluxo de branch, escopo, convenções do projeto e tratamento de dúvidas.]
15
+
16
+ ## Validar e entregar
17
+
18
+ [Comandos de testes/lint/build aplicáveis, atualização da documentação e
19
+ revisão de entrega antes do commit/merge. Indique onde consultar os critérios.]
20
+
21
+ ## Pedir ajuda
22
+
23
+ [Canais existentes e informações necessárias para reportar um problema.]
@@ -0,0 +1,30 @@
1
+ ---
2
+ description: Design técnico da solução.
3
+ status: rascunho
4
+ ---
5
+
6
+ # Design técnico
7
+
8
+ ## Referências ao PRD e UX/UI
9
+
10
+ A definir.
11
+
12
+ ## Contexto e requisitos
13
+
14
+ A definir.
15
+
16
+ ## Arquitetura e tecnologia
17
+
18
+ A definir.
19
+
20
+ ## Alternativas, riscos e qualidade
21
+
22
+ A definir.
23
+
24
+ ## Validação e pendências
25
+
26
+ A definir.
27
+
28
+ ## Aprovação
29
+
30
+ Pendente.
@@ -0,0 +1,19 @@
1
+ ---
2
+ description: Funcionamento e descoberta dos recursos compartilhados dos agentes.
3
+ ---
4
+
5
+ # Instruções para agentes
6
+
7
+ A origem compartilhada é `.pbai4devs` (PathBit AI For Devs).
8
+ Leia `.pbai4devs/INSTRUCTIONS.md` para a ordem de trabalho e os pré-requisitos.
9
+
10
+ Skills: `.pbai4devs/skills/README.md`.
11
+ Comandos: `.pbai4devs/commands/README.md`.
12
+ Regras: `.pbai4devs/rules/README.md`. Perfis: `.pbai4devs/agents/README.md`.
13
+ O inventário completo fica em `.pbai4devs/catalog.json` e os formatos de cada
14
+ cliente em `.pbai4devs/COMPATIBILIDADE.md`.
15
+
16
+ Use o `README.md` do projeto para seu contexto. Os clientes escolhidos têm
17
+ apontamentos; scripts, ferramentas e modelos permanecem na origem compartilhada.
18
+ Respeite a seleção em `.pbai4devs/estado/agentdevkit.json`. Para alterá-la, use
19
+ `agents` na CLI; não deduza o agente ativo pelo aplicativo ou pelas pastas.
@@ -0,0 +1,7 @@
1
+ ---
2
+ description: "Instruções do projeto para Claude."
3
+ ---
4
+
5
+ # Instruções para Claude
6
+
7
+ @AGENTS.md
@@ -0,0 +1,7 @@
1
+ ---
2
+ description: Instruções compartilhadas para Gemini.
3
+ ---
4
+
5
+ # Instruções para Gemini
6
+
7
+ @./AGENTS.md
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: Entradas genéricas usadas pelo instalador e pelos testes de projetos.
3
+ status: modelo
4
+ ---
5
+
6
+ # Entradas dos agentes
7
+
8
+ O instalador gera [AGENTS](AGENTS.md), [CLAUDE](CLAUDE.md) e
9
+ [GEMINI](GEMINI.md) conforme os clientes escolhidos. Entradas humanas são
10
+ preservadas; somente blocos antigos identificados do kit são migrados.
11
+ Os modelos apontam para a fonte compartilhada. O simulador usa estas entradas
12
+ para representar a instalação real.
@@ -0,0 +1,42 @@
1
+ ---
2
+ description: Bloco customizado obrigatório ao final do gitignore.
3
+ ---
4
+
5
+ # Custom ignore
6
+
7
+ Ao criar ou atualizar `.gitignore`, mantenha este bloco no final. Preserve
8
+ exceções existentes e acrescente os ignorados específicos da tecnologia aqui.
9
+ Regras de artefatos locais vêm de [shared.ignore](shared.ignore) e
10
+ [agents.ignore](agents.ignore). As saídas calculadas usam
11
+ [local.ignore](local.ignore) em `.git/info/exclude`; sem Git, um bloco gerado
12
+ na raiz protege os arquivos e migra para `exclude` após `git init` e `sync`.
13
+ O sincronizador mantém o bloco `BEGIN AGENT IGNORE` / `END AGENT IGNORE`;
14
+ regras próprias ficam fora dele, com exceções depois do bloco. Para permitir
15
+ novos arquivos compartilhados, ajuste as fontes e sincronize. Raízes dedicadas
16
+ dos clientes são locais. Em `.github` e `.vscode`, arquivos próprios continuam
17
+ elegíveis; somente os derivados são excluídos.
18
+ Ignore binários baixados por local, não por extensão: `.bat`, `.exe` e outros
19
+ arquivos podem ser scripts ou fixtures necessários. Não use regras genéricas
20
+ como `Release/`, `Scripts/` ou `Lib/` que escondam fontes e modelos.
21
+ Ignore qualquer arquivo ou pasta `.playwright*`, em qualquer combinação de
22
+ maiúsculas/minúsculas, inclusive `.playwright-mcp`.
23
+
24
+ ```gitignore
25
+ # ---------------------------
26
+ # CUSTOM IGNORE
27
+ # ---------------------------
28
+
29
+ ## Testes e artefatos locais de agentes
30
+ /.[Aa][Gg][Ee][Nn][Tt]-[Tt][Ee][Ss][Tt][Ss]/
31
+
32
+ ## Resultados e relatórios de testes
33
+ [Tt][Ee][Ss][Tt][Rr][Ee][Ss][Uu][Ll][Tt][Ss]/
34
+ [Tt][Ee][Ss][Tt]-[Rr][Ee][Ss][Uu][Ll][Tt][Ss]/
35
+ .[Pp][Ll][Aa][Yy][Ww][Rr][Ii][Gg][Hh][Tt]*
36
+ [Pp][Ll][Aa][Yy][Ww][Rr][Ii][Gg][Hh][Tt]*/
37
+ [Bb][Ll][Oo][Bb]-[Rr][Ee][Pp][Oo][Rr][Tt]/
38
+
39
+ ## Temporary folder and files
40
+ **/[Tt][Mm][Pp]
41
+ **/[Tt][Ee][Mm][Pp]
42
+ ```
@@ -0,0 +1,45 @@
1
+ # ---------------------------
2
+ # CUSTOM IGNORE
3
+ # ---------------------------
4
+
5
+ ## Estado local, caches e credenciais conhecidas
6
+ **/.[Ll][Oo][Cc][Aa][Ll]/
7
+ **/.[Cc][Aa][Cc][Hh][Ee]/
8
+ /[Cc][Aa][Cc][Hh][Ee]/
9
+ **/[Nn][Oo][Dd][Ee]_[Mm][Oo][Dd][Uu][Ll][Ee][Ss]/
10
+ **/__pycache__/
11
+ **/.DS_Store
12
+ **/._*
13
+ **/Thumbs.db
14
+ **/Desktop.ini
15
+ **/*.[Ss][Ww][Pp]
16
+ **/*.[Ss][Ww][Oo]
17
+ **/*~
18
+ **/[Ss][Ee][Ss][Ss][Ii][Oo][Nn][Ss]/
19
+ **/[Ll][Oo][Gg][Ss]/
20
+ **/[Oo][Pp][Ee][Nn][Cc][Oo][Dd][Ee]-[Ll][Oo][Oo][Pp]/
21
+ **/[Aa][Uu][Tt][Hh].[Jj][Ss][Oo][Nn]
22
+ **/[Cc][Rr][Ee][Dd][Ee][Nn][Tt][Ii][Aa][Ll][Ss].[Jj][Ss][Oo][Nn]
23
+ **/[Hh][Ii][Ss][Tt][Oo][Rr][Yy].[Jj][Ss][Oo][Nn][Ll]
24
+ **/*.[Ll][Oo][Cc][Aa][Ll].[Jj][Ss][Oo][Nn]
25
+ **/*.[Ll][Oo][Cc][Aa][Ll].[Jj][Ss][Oo][Nn][Cc]
26
+ **/*.[Ll][Oo][Cc][Aa][Ll].[Tt][Oo][Mm][Ll]
27
+ **/*.[Ll][Oo][Cc][Aa][Ll].[Yy][Aa][Mm][Ll]
28
+ **/*.[Ll][Oo][Cc][Aa][Ll].[Yy][Mm][Ll]
29
+ **/*.[Ll][Oo][Gg]
30
+ **/.[Ee][Nn][Vv]
31
+ **/.[Ee][Nn][Vv].*
32
+ !**/.env.example
33
+ !**/.env.sample
34
+ !**/.env.template
35
+ !**/.env.*.example
36
+
37
+ ## Resultados e arquivos temporarios
38
+ **/.[Aa][Gg][Ee][Nn][Tt]-[Tt][Ee][Ss][Tt][Ss]/
39
+ **/[Tt][Ee][Ss][Tt][Rr][Ee][Ss][Uu][Ll][Tt][Ss]/
40
+ **/[Tt][Ee][Ss][Tt]-[Rr][Ee][Ss][Uu][Ll][Tt][Ss]/
41
+ **/.[Pp][Ll][Aa][Yy][Ww][Rr][Ii][Gg][Hh][Tt]*
42
+ **/[Pp][Ll][Aa][Yy][Ww][Rr][Ii][Gg][Hh][Tt]*/
43
+ **/[Bb][Ll][Oo][Bb]-[Rr][Ee][Pp][Oo][Rr][Tt]/
44
+ **/[Tt][Mm][Pp]/
45
+ **/[Tt][Ee][Mm][Pp]/
@@ -0,0 +1,20 @@
1
+ {
2
+ ".agents": { "allow": ["skills.json", "rules.json", "agents.json"] },
3
+ ".agent": { "allow": [] },
4
+ ".gemini": { "allow": ["settings.json", "GEMINI.md"] },
5
+ ".claude": { "allow": ["settings.json", "CLAUDE.md"] },
6
+ ".codex": { "allow": ["config.toml", "requirements.toml"] },
7
+ ".cursor": { "allow": ["mcp.json"] },
8
+ ".opencode": { "allow": ["opencode.json", "opencode.jsonc"] },
9
+ ".github": {
10
+ "allow": [
11
+ "copilot-instructions.md", "instructions/", "prompts/", "workflows/",
12
+ "actions/", "CODEOWNERS", "dependabot.yml", "ISSUE_TEMPLATE/",
13
+ "PULL_REQUEST_TEMPLATE/", "PULL_REQUEST_TEMPLATE.md", "FUNDING.yml"
14
+ ]
15
+ },
16
+ ".vscode": {
17
+ "resources": false,
18
+ "allow": ["settings.json", "extensions.json", "tasks.json", "launch.json"]
19
+ }
20
+ }
@@ -0,0 +1,10 @@
1
+ # Derivados locais do AgentDevKit
2
+ /.pbai4devs/catalog.json
3
+ /.pbai4devs/skills.json
4
+ /.pbai4devs/agents.json
5
+ /.pbai4devs/rules.json
6
+ /.pbai4devs/espelhos.conf
7
+ /.pbai4devs/estado/agentdevkit.json
8
+ /.pbai4devs/estado/derived.json
9
+ {{ROOTS}}
10
+ {{OUTPUTS}}