aidd-cli 0.2.0__tar.gz → 0.5.0__tar.gz

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 (307) hide show
  1. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/MANIFEST.in +3 -3
  2. {aidd_cli-0.2.0/aidd_cli.egg-info → aidd_cli-0.5.0}/PKG-INFO +1 -1
  3. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/README.md +266 -266
  4. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/AGENTS.md.snippet +3 -2
  5. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/GEMINI.md +16 -16
  6. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/README.md +241 -241
  7. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/antigravity/rules/aidd.md +29 -29
  8. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/antigravity/skills/aidd/SKILL.md +30 -30
  9. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/AIDD.md +708 -693
  10. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/CORE.md +133 -120
  11. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/hooks/_common.py +197 -197
  12. aidd_cli-0.5.0/adapters/dot-aidd/hooks/codex_patch.py +181 -0
  13. aidd_cli-0.5.0/adapters/dot-aidd/hooks/codex_subagent.py +63 -0
  14. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/hooks/host_adapter.py +696 -659
  15. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/hooks/mark_agent_dispatch.py +169 -159
  16. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/hooks/mark_code_edit.py +141 -139
  17. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/hooks/record_dispatch_pre.py +57 -57
  18. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/hooks/require_aidd.py +66 -66
  19. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/hooks/require_graph_coherence_audit.py +150 -150
  20. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/hooks/require_independent_audit.py +83 -83
  21. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/hooks/rule_gate.py +2120 -1980
  22. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_amendment_verify.py +489 -0
  23. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/aidd_calibrate.py +135 -135
  24. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_close_ledger.py +340 -0
  25. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_coverage.py +573 -0
  26. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_doctor.py +656 -656
  27. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_embed.py +44 -0
  28. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_evidence.py +2446 -2257
  29. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_gitignore.py +57 -0
  30. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_graphs.py +189 -47
  31. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_guard.py +729 -495
  32. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/aidd_job.py +726 -726
  33. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_memory.py +1379 -1379
  34. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_memory_import.py +403 -378
  35. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_navigator.py +196 -0
  36. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/aidd_next.py +230 -216
  37. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_pending.py +173 -0
  38. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_progress.py +510 -347
  39. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_provider_attestation.py +526 -0
  40. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_readiness.py +128 -0
  41. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_red.py +279 -0
  42. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_reuse.py +104 -0
  43. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_review.py +1756 -1381
  44. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/aidd_review_items.py +1042 -1042
  45. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/aidd_review_state.py +627 -627
  46. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_round.py +773 -0
  47. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_rules.py +822 -39
  48. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_source_shape.py +137 -0
  49. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_sqlcheck.py +268 -220
  50. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_status.py +4081 -0
  51. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_sync.py +391 -0
  52. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_tools.py +345 -337
  53. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/aidd_triage.py +132 -132
  54. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_unit_audit.py +795 -0
  55. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_unit_consent.py +54 -0
  56. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_unit_visual.py +240 -0
  57. aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_units.py +782 -0
  58. aidd_cli-0.5.0/adapters/dot-aidd/scripts/alias_graph.py +153 -0
  59. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/check_charter.py +43 -11
  60. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/check_spec.py +731 -699
  61. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/code_graph.py +5 -5
  62. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/component_graph.py +536 -536
  63. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/find_spec.py +1315 -1284
  64. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/flowmap.py +1542 -1541
  65. aidd_cli-0.5.0/adapters/dot-aidd/scripts/graph_explorer.py +1644 -0
  66. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/graph_snapshot.py +1098 -1098
  67. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/graph_trace.py +733 -733
  68. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/method_graph.py +297 -297
  69. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/sql_graph.py +1125 -1125
  70. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/tasks_to_issues.py +283 -283
  71. aidd_cli-0.5.0/adapters/dot-aidd/scripts/unified_graph.py +405 -0
  72. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/STATE.md +41 -41
  73. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/calibration.toon +6 -6
  74. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/templates/charter.md +1 -1
  75. aidd_cli-0.5.0/adapters/dot-aidd/templates/gitignore.aidd +9 -0
  76. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/templates/mockup-audit.md +10 -0
  77. aidd_cli-0.5.0/adapters/dot-aidd/templates/navigator.html +32 -0
  78. aidd_cli-0.5.0/adapters/dot-aidd/templates/perf/README.md +22 -0
  79. aidd_cli-0.5.0/adapters/dot-aidd/templates/perf/plan-risk.test.sql +72 -0
  80. aidd_cli-0.5.0/adapters/dot-aidd/templates/perf/seed-generate-series.sql +52 -0
  81. {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/templates/qa-audit.md +83 -83
  82. aidd_cli-0.5.0/adapters/dot-aidd/templates/review.html +1288 -0
  83. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/spec.md +20 -3
  84. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/tasks.md +102 -102
  85. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/opencode/plugins/aidd.js +116 -116
  86. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/opencode/skills/aidd/SKILL.md +33 -33
  87. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/aidd/__init__.py +10 -10
  88. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/aidd/cli.py +730 -619
  89. {aidd_cli-0.2.0 → aidd_cli-0.5.0/aidd_cli.egg-info}/PKG-INFO +1 -1
  90. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/aidd_cli.egg-info/SOURCES.txt +56 -61
  91. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/pyproject.toml +38 -38
  92. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/setup.py +32 -32
  93. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/AIDD.md +708 -693
  94. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/SKILL.md +553 -501
  95. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/hooks/_common.py +197 -197
  96. aidd_cli-0.5.0/skill/hooks/codex_patch.py +181 -0
  97. aidd_cli-0.5.0/skill/hooks/codex_subagent.py +63 -0
  98. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/graph_refresh.py +98 -98
  99. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/host_adapter.py +696 -659
  100. aidd_cli-0.5.0/skill/hooks/mark_agent_dispatch.py +169 -0
  101. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/mark_code_edit.py +141 -139
  102. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/mark_user_question.py +22 -1
  103. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/prompt_trigger.py +330 -330
  104. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/read_hint.py +295 -295
  105. aidd_cli-0.5.0/skill/hooks/record_dispatch_pre.py +57 -0
  106. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/require_aidd.py +66 -66
  107. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/hooks/require_graph_coherence_audit.py +150 -150
  108. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/hooks/require_independent_audit.py +83 -83
  109. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/hooks/rule_gate.py +2120 -1980
  110. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/session_start.py +67 -67
  111. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/stop_gate.py +274 -274
  112. aidd_cli-0.5.0/skill/hooks/tool_first_hint.py +284 -0
  113. aidd_cli-0.5.0/skill/scripts/aidd_amendment_verify.py +489 -0
  114. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/aidd_calibrate.py +135 -135
  115. aidd_cli-0.5.0/skill/scripts/aidd_close_ledger.py +340 -0
  116. aidd_cli-0.5.0/skill/scripts/aidd_coverage.py +573 -0
  117. aidd_cli-0.5.0/skill/scripts/aidd_doctor.py +656 -0
  118. aidd_cli-0.5.0/skill/scripts/aidd_embed.py +44 -0
  119. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_evidence.py +2446 -2257
  120. aidd_cli-0.5.0/skill/scripts/aidd_gitignore.py +57 -0
  121. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_graphs.py +189 -47
  122. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_guard.py +729 -495
  123. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/aidd_job.py +726 -726
  124. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_memory.py +1379 -1379
  125. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_memory_import.py +403 -378
  126. aidd_cli-0.5.0/skill/scripts/aidd_navigator.py +196 -0
  127. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/aidd_next.py +230 -216
  128. aidd_cli-0.5.0/skill/scripts/aidd_pending.py +173 -0
  129. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_progress.py +510 -347
  130. aidd_cli-0.5.0/skill/scripts/aidd_provider_attestation.py +526 -0
  131. aidd_cli-0.5.0/skill/scripts/aidd_readiness.py +128 -0
  132. aidd_cli-0.5.0/skill/scripts/aidd_red.py +279 -0
  133. aidd_cli-0.5.0/skill/scripts/aidd_reuse.py +104 -0
  134. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_review.py +1756 -1381
  135. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/aidd_review_items.py +1042 -1042
  136. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/aidd_review_state.py +627 -627
  137. aidd_cli-0.5.0/skill/scripts/aidd_round.py +773 -0
  138. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_rules.py +822 -39
  139. aidd_cli-0.5.0/skill/scripts/aidd_source_shape.py +137 -0
  140. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_sqlcheck.py +268 -220
  141. aidd_cli-0.5.0/skill/scripts/aidd_status.py +4081 -0
  142. aidd_cli-0.5.0/skill/scripts/aidd_sync.py +391 -0
  143. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_tools.py +345 -337
  144. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/aidd_triage.py +132 -132
  145. aidd_cli-0.5.0/skill/scripts/aidd_unit_audit.py +795 -0
  146. aidd_cli-0.5.0/skill/scripts/aidd_unit_consent.py +54 -0
  147. aidd_cli-0.5.0/skill/scripts/aidd_unit_visual.py +240 -0
  148. aidd_cli-0.5.0/skill/scripts/aidd_units.py +782 -0
  149. aidd_cli-0.5.0/skill/scripts/alias_graph.py +153 -0
  150. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/check_charter.py +43 -11
  151. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/check_spec.py +731 -699
  152. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/code_graph.py +5 -5
  153. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/component_graph.py +536 -536
  154. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/find_spec.py +1315 -1284
  155. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/flowmap.py +1542 -1541
  156. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/generate_adapters.py +221 -221
  157. aidd_cli-0.5.0/skill/scripts/graph_explorer.py +1644 -0
  158. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/graph_snapshot.py +1098 -1098
  159. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/graph_trace.py +733 -733
  160. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/install_hooks.py +263 -261
  161. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/install_host.py +740 -732
  162. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/marketplace.py +262 -262
  163. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/method_graph.py +297 -297
  164. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/research_project.py +6 -9
  165. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/sql_graph.py +1125 -1125
  166. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/tasks_to_issues.py +283 -283
  167. aidd_cli-0.5.0/skill/scripts/unified_graph.py +405 -0
  168. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/STATE.md +41 -41
  169. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/calibration.toon +6 -6
  170. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/templates/charter.md +1 -1
  171. aidd_cli-0.5.0/skill/templates/gitignore.aidd +9 -0
  172. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/templates/mockup-audit.md +10 -0
  173. aidd_cli-0.5.0/skill/templates/navigator.html +32 -0
  174. aidd_cli-0.5.0/skill/templates/perf/README.md +22 -0
  175. aidd_cli-0.5.0/skill/templates/perf/plan-risk.test.sql +72 -0
  176. aidd_cli-0.5.0/skill/templates/perf/seed-generate-series.sql +52 -0
  177. {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/templates/qa-audit.md +83 -83
  178. aidd_cli-0.5.0/skill/templates/review.html +1288 -0
  179. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/spec.md +20 -3
  180. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/tasks.md +107 -107
  181. aidd_cli-0.2.0/adapters/dot-aidd/scripts/aidd_pending.py +0 -82
  182. aidd_cli-0.2.0/adapters/dot-aidd/scripts/aidd_status.py +0 -2020
  183. aidd_cli-0.2.0/adapters/dot-aidd/scripts/graph_explorer.py +0 -207
  184. aidd_cli-0.2.0/adapters/dot-aidd/templates/review.html +0 -551
  185. aidd_cli-0.2.0/skill/scripts/aidd_pending.py +0 -82
  186. aidd_cli-0.2.0/skill/scripts/aidd_status.py +0 -2020
  187. aidd_cli-0.2.0/skill/scripts/graph_explorer.py +0 -207
  188. aidd_cli-0.2.0/skill/templates/review.html +0 -551
  189. aidd_cli-0.2.0/tests/test_aidd_calibrate.py +0 -165
  190. aidd_cli-0.2.0/tests/test_aidd_graphs.py +0 -220
  191. aidd_cli-0.2.0/tests/test_aidd_guard.py +0 -461
  192. aidd_cli-0.2.0/tests/test_aidd_job.py +0 -249
  193. aidd_cli-0.2.0/tests/test_aidd_memory.py +0 -825
  194. aidd_cli-0.2.0/tests/test_aidd_memory_import.py +0 -398
  195. aidd_cli-0.2.0/tests/test_aidd_next.py +0 -166
  196. aidd_cli-0.2.0/tests/test_aidd_progress.py +0 -141
  197. aidd_cli-0.2.0/tests/test_aidd_review.py +0 -1437
  198. aidd_cli-0.2.0/tests/test_aidd_review_items.py +0 -1006
  199. aidd_cli-0.2.0/tests/test_aidd_review_state.py +0 -681
  200. aidd_cli-0.2.0/tests/test_aidd_rules.py +0 -2469
  201. aidd_cli-0.2.0/tests/test_aidd_rules_r10.py +0 -394
  202. aidd_cli-0.2.0/tests/test_aidd_sqlcheck.py +0 -106
  203. aidd_cli-0.2.0/tests/test_aidd_status.py +0 -2532
  204. aidd_cli-0.2.0/tests/test_aidd_tools.py +0 -174
  205. aidd_cli-0.2.0/tests/test_aidd_triage.py +0 -133
  206. aidd_cli-0.2.0/tests/test_check_charter.py +0 -151
  207. aidd_cli-0.2.0/tests/test_check_spec.py +0 -411
  208. aidd_cli-0.2.0/tests/test_cli_mem.py +0 -44
  209. aidd_cli-0.2.0/tests/test_cli_rules.py +0 -204
  210. aidd_cli-0.2.0/tests/test_code_fingerprint.py +0 -187
  211. aidd_cli-0.2.0/tests/test_code_graph.py +0 -252
  212. aidd_cli-0.2.0/tests/test_component_graph.py +0 -279
  213. aidd_cli-0.2.0/tests/test_dot_aidd_mirror.py +0 -521
  214. aidd_cli-0.2.0/tests/test_evidence.py +0 -1632
  215. aidd_cli-0.2.0/tests/test_extension_providers.py +0 -427
  216. aidd_cli-0.2.0/tests/test_find_spec.py +0 -686
  217. aidd_cli-0.2.0/tests/test_flowmap.py +0 -102
  218. aidd_cli-0.2.0/tests/test_generate_adapters.py +0 -202
  219. aidd_cli-0.2.0/tests/test_graph_explorer.py +0 -114
  220. aidd_cli-0.2.0/tests/test_graph_refresh_hook.py +0 -135
  221. aidd_cli-0.2.0/tests/test_graph_snapshot.py +0 -409
  222. aidd_cli-0.2.0/tests/test_graph_trace_method.py +0 -371
  223. aidd_cli-0.2.0/tests/test_graphs_auto.py +0 -113
  224. aidd_cli-0.2.0/tests/test_hooks.py +0 -1309
  225. aidd_cli-0.2.0/tests/test_host_doctor.py +0 -480
  226. aidd_cli-0.2.0/tests/test_host_gates.py +0 -1036
  227. aidd_cli-0.2.0/tests/test_host_install.py +0 -640
  228. aidd_cli-0.2.0/tests/test_install_ci.py +0 -108
  229. aidd_cli-0.2.0/tests/test_install_hooks.py +0 -311
  230. aidd_cli-0.2.0/tests/test_link_pr_to_task.py +0 -196
  231. aidd_cli-0.2.0/tests/test_marketplace.py +0 -280
  232. aidd_cli-0.2.0/tests/test_memory_hooks.py +0 -155
  233. aidd_cli-0.2.0/tests/test_perf_budget.py +0 -263
  234. aidd_cli-0.2.0/tests/test_prompt_trigger.py +0 -244
  235. aidd_cli-0.2.0/tests/test_r14.py +0 -295
  236. aidd_cli-0.2.0/tests/test_r9_transcript.py +0 -64
  237. aidd_cli-0.2.0/tests/test_read_hint.py +0 -234
  238. aidd_cli-0.2.0/tests/test_research_project.py +0 -110
  239. aidd_cli-0.2.0/tests/test_review_template.py +0 -695
  240. aidd_cli-0.2.0/tests/test_rule_gate.py +0 -2837
  241. aidd_cli-0.2.0/tests/test_rule_gate_shell_speed.py +0 -404
  242. aidd_cli-0.2.0/tests/test_sql_graph.py +0 -249
  243. aidd_cli-0.2.0/tests/test_sql_graph_incremental.py +0 -270
  244. aidd_cli-0.2.0/tests/test_stop_gate.py +0 -452
  245. aidd_cli-0.2.0/tests/test_sync_issues.py +0 -167
  246. aidd_cli-0.2.0/tests/test_tasks_to_issues.py +0 -185
  247. aidd_cli-0.2.0/tests/test_transcript_sync.py +0 -313
  248. aidd_cli-0.2.0/tests/test_typed_confirmations.py +0 -305
  249. aidd_cli-0.2.0/tests/test_validate_catalog_entry.py +0 -185
  250. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/LICENSE +0 -0
  251. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/extensions/azure_devops/manifest.json +0 -0
  252. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/extensions/azure_devops/provider.py +0 -0
  253. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/extensions/bitbucket/manifest.json +0 -0
  254. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/extensions/bitbucket/provider.py +0 -0
  255. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/extensions/github/manifest.json +0 -0
  256. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/extensions/github/provider.py +0 -0
  257. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/extension_registry.py +0 -0
  258. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/link_pr_to_task.py +0 -0
  259. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/sync_issues.py +0 -0
  260. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/comprehensive-documentation.md +0 -0
  261. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/contracts.md +0 -0
  262. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/data-model.md +0 -0
  263. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/design-system/MASTER.md +0 -0
  264. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/design-system/components-index.md +0 -0
  265. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/design-system/page-override.md +0 -0
  266. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/plan.md +0 -0
  267. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/research.md +0 -0
  268. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/review-full.html +0 -0
  269. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/traceability.md +0 -0
  270. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/visual-flow.toon +0 -0
  271. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/aidd_cli.egg-info/dependency_links.txt +0 -0
  272. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/aidd_cli.egg-info/entry_points.txt +0 -0
  273. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/aidd_cli.egg-info/top_level.txt +0 -0
  274. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/setup.cfg +0 -0
  275. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/adapters/cline/manifest.json +0 -0
  276. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/adapters/copilot/manifest.json +0 -0
  277. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/adapters/cursor/manifest.json +0 -0
  278. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/adapters/gemini/manifest.json +0 -0
  279. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/adapters/windsurf/manifest.json +0 -0
  280. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/azure_devops/manifest.json +0 -0
  281. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/azure_devops/provider.py +0 -0
  282. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/bitbucket/manifest.json +0 -0
  283. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/bitbucket/provider.py +0 -0
  284. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/github/manifest.json +0 -0
  285. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/github/provider.py +0 -0
  286. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/mark_graph_rebuild.py +0 -0
  287. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/mark_invoked.py +0 -0
  288. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/memory_context.py +0 -0
  289. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/memory_file_context.py +0 -0
  290. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/extension_registry.py +0 -0
  291. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/install_ci.py +0 -0
  292. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/link_pr_to_task.py +0 -0
  293. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/sync_issues.py +0 -0
  294. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/validate_catalog_entry.py +0 -0
  295. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/ci/azure-pipelines-aidd.yml +0 -0
  296. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/ci/github-actions-aidd.yml +0 -0
  297. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/comprehensive-documentation.md +0 -0
  298. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/contracts.md +0 -0
  299. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/data-model.md +0 -0
  300. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/design-system/MASTER.md +0 -0
  301. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/design-system/components-index.md +0 -0
  302. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/design-system/page-override.md +0 -0
  303. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/plan.md +0 -0
  304. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/research.md +0 -0
  305. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/review-full.html +0 -0
  306. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/traceability.md +0 -0
  307. {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/visual-flow.toon +0 -0
@@ -1,3 +1,3 @@
1
- graft skill
2
- graft adapters
3
- global-exclude __pycache__ *.pyc *.bak *.spill
1
+ graft skill
2
+ graft adapters
3
+ global-exclude __pycache__ *.pyc *.bak *.spill
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: aidd-cli
3
- Version: 0.2.0
3
+ Version: 0.5.0
4
4
  Summary: AIDD — a methodology for working with AI coding agents (CLI distribution)
5
5
  License-Expression: MIT
6
6
  Project-URL: Homepage, https://github.com/quimhen/aidd
@@ -1,266 +1,266 @@
1
- <div align="center">
2
-
3
- # ⚡ AIDD — AI-Driven Development
4
- ### Stop AI coding agents from grading their own homework.
5
-
6
- [![PyPI version](https://img.shields.io/pypi/v/aidd-cli.svg?color=blue)](https://pypi.org/project/aidd-cli/)
7
- [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
8
- [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/)
9
- [![Tested on Claude Code](https://img.shields.io/badge/Enforced_on-Claude_Code-purple.svg)](https://claude.ai)
10
- [![Sponsor](https://img.shields.io/badge/sponsor-%E2%9D%A4-db61a2)](https://github.com/sponsors/quimhen)
11
-
12
- **A methodology with technical teeth for AI coding agents (Claude Code, OpenCode, Codex, Gemini CLI).**
13
- It forces agents to search before creating, plan out loud before coding, and blocks self-approval
14
- via automated hooks — not another AI coding agent itself, a set of habits your existing one follows.
15
-
16
- [Explore Landing](https://aidd-landing.vercel.app/) · [Why AIDD](docs/WHY-AIDD.md) · [Pipeline Docs](docs/PIPELINE.md) · [Report Bug](https://github.com/quimhen/aidd/issues)
17
-
18
- </div>
19
-
20
- ---
21
-
22
- ### 🚀 10-Second Quick Start
23
-
24
- Get started in any existing repository without modifying your code:
25
-
26
- ```bash
27
- # 1. Install the CLI
28
- pip install aidd-cli
29
-
30
- # 2. Initialize in your project
31
- aidd init .
32
-
33
- # 3. Check for architectural violations & spec gaps
34
- aidd check-charter .
35
- aidd search "auth flow"
36
- ```
37
-
38
- > **Using Claude Code?** Install the technical enforcement gates with one command:
39
- > ```bash
40
- > cp -r skill ~/.claude/skills/aidd && python ~/.claude/skills/aidd/scripts/install_hooks.py
41
- > ```
42
-
43
- <div align="center">
44
- <img src="docs/assets/demo-terminal.svg" alt="AIDD hook blocking a self-approved PR, then dispatching an independent QA subagent" width="760" />
45
- </div>
46
-
47
- ---
48
-
49
- ### ⚖️ Why AIDD vs. traditional prompts / spec files
50
-
51
- | Feature | Traditional rules (`CLAUDE.md`, `.cursorrules`) | AIDD methodology |
52
- | :--- | :--- | :--- |
53
- | **Compliance** | Optional (LLMs tend to skip long instructions) | **Strict / blocking** (real system hooks) |
54
- | **Code review** | The same agent grades its own code | **Independent subagent audit, mandatory** |
55
- | **UI mapping** | Duplicated, per-screen prose | **Unified codes** (`COMP-nnn`, `CTL-nnn`) |
56
- | **Task tracking** | Disconnected markdown nobody re-checks | **Bidirectional sync** with GitHub / Azure DevOps / Bitbucket |
57
- | **Context cost** | Dumps thousands of tokens into every prompt | **Indexed local lookup** (`find_spec.py`) |
58
-
59
- ## The problem
60
-
61
- AI coding agents are fast at writing code and bad at knowing what already exists. Left alone, they
62
- duplicate specs nobody asked for, re-explain a flow in three paragraphs instead of drawing it, ship
63
- a fix that fabricates success instead of actually calling the real backend, and grade their own
64
- homework when asked to review it. AIDD is the set of habits that stops that — enforced by hooks
65
- where the tool allows it, followed as a written discipline everywhere else.
66
-
67
- ## What it does
68
-
69
- - **Searches before creating.** Every request runs against a compact, auto-built graph of every
70
- existing spec (`specs/index.toon`) before anything new gets created — a match means "amend this,"
71
- not "start over."
72
- - **Shows the plan before building it.** Step 1.5 turns each use case into an interactive
73
- actors × processes flow with generated pseudocode (`aidd flow specs/001-login/visual-flow.toon
74
- --open`) — the user clicks through it and corrects the flow by node, not in prose. Source is
75
- a compact TOON file; layout, routing and pseudocode are derived, never hand-drawn.
76
- - **Plans out loud.** Ambiguity gets resolved as an explicit question before code is written, not
77
- discovered after a review.
78
- - **Ships in small, reviewable pieces.** One code, one file, one PR — a wrong pass costs one edit,
79
- not a rewrite.
80
- - **Never lets the implementer grade its own work.** Step 6's review must come from a separate
81
- agent dispatch, one per domain the change touched. On Claude Code this is an actual technical
82
- gate (`hooks/rule_gate.py` + `stop_gate.py`), not just a rule stated in a doc.
83
- - **Enforces the rules instead of asking nicely.** Hard rules R1–R12: estimates are agent
84
- minutes per wave (human hours only as a reference), skipping a step needs the user's quoted
85
- confirmation (verified against what the user typed or answered), the agent can't answer its own
86
- Align questions (blank answers block planning, `repo —` sources must exist and cite a line),
87
- plan/tasks can't be written out of order, `tasks.md` approval is the user's recorded "Approve"
88
- answer plus a tamper-evident hash, a spec stays open until `aidd rules close`/`abandon` (touching
89
- another spec can't switch the gates off), code edits are blocked for every open spec without a
90
- recorded approval, every required domain needs its own distinct auditor, and a session can't
91
- end on built code without its closing audits (R8 relaxes after 3 blocks); a ✅ screen/API/field
92
- needs executed evidence, not a code reading (R10, freshness best-effort), a repeated bug needs a
93
- root cause and pattern sweep (R11), and a task that reuses a screen/component must say whether it is a
94
- new view or logic only (R12). Hooks write an
95
- append-only evidence log (guarded against the agent by R9: the Write/Edit tools and a lexical shell guard, not a sandbox) (per-session in the temp dir, plus a project log only where
96
- a `specs/` or `.aidd/` root exists) that the gates read; `aidd status` lists every open spec with the
97
- ledger and **WHY blocked**, and `aidd rules check` prints `PASS|FAIL Rn … → fix`.
98
- Honest limits: Claude Code only; **Bash and PowerShell can still edit code** and, through the CLI or
99
- libraries, try to forge evidence (the guard is lexical, not a sandbox); the gates check that a
100
- subagent ran and a question was answered, not that they were good; the user's click cannot be
101
- proven; hooks fail open on a crash, launch failure or timeout (recorded as `hook_error` when
102
- possible); session ids/resume behaviour are not verified. The rules stop accidental and
103
- self-justified skipping, not a determined agent. `AIDD_RULES=off|0|false|no|warn` is the
104
- owner's escape hatch.
105
- - **Remembers the why.** Decisions, rejected options, bug root causes and constraints go into
106
- `.aidd/memory/` as curated, code-anchored AIDD-TOON entries, committed with the code — no
107
- daemon, no LLM observer, no vectors, stdlib only. Search is progressive: `aidd mem search`
108
- returns one line per hit, `aidd mem show <id>` the full row. On Claude Code `memory_context.py` surfaces
109
- the relevant entries at session start (installed by default; the per-file `memory_file_context.py` is opt-in). `STATE.md` stays
110
- "where am I", `specs/index.toon` stays "what exists"; memory is "why". A one-off, read-only
111
- importer can seed it from a claude-mem database (secrets and IPs scrubbed). Memory is committed content that gets injected into sessions: review it like code.
112
- - **Works the same across tools.** One methodology (`skill/AIDD.md`), thin adapters per tool — no
113
- relearning the process when the assistant changes. For Claude Code, OpenCode, and Codex, that's
114
- a native skill/AGENTS.md pointer; for Gemini CLI, Cursor, Windsurf, Cline, and GitHub Copilot,
115
- `generate_adapters.py` renders each one's own native command-file format straight from
116
- `commands/aidd-*.md` — one source, no per-agent copy to keep in sync. Both the issue-tracker
117
- providers and these adapter targets are auto-discovered extensions (see
118
- [`docs/EXTENDING.md`](docs/EXTENDING.md)), so a project can add its own without forking this repo.
119
- - **Has a charter that's actually checked.** Project-wide rules split into judgment calls
120
- (prose) and checkable ones (a pattern + glob table `check_charter.py` runs for real) — not
121
- a principles doc trusted to memory. Run against a real production project, it caught two
122
- stale claims in that project's own hand-written notes about specific libraries being unused
123
- (both false, verified in seconds) and a third that turned out far worse than self-rated
124
- (340 real violations of a rule logged as low-severity).
125
- - **Verifies its own map before planning against it.** The spec graph is parsed mechanically
126
- (fast, cheap), which also means it can misparse a renamed code or a stale relationship — so a
127
- rebuild dispatches an independent Graph Coherence Auditor before `plan.md`/`tasks.md` build on
128
- the new edges. Enforced by a hook pair, not a step an agent could skip under time pressure.
129
- - **Syncs to GitHub, Azure DevOps, or Bitbucket — not just markdown.** An approved `tasks.md`
130
- becomes real, trackable issues via `tasks_to_issues.py --provider {github,azure_devops,
131
- bitbucket}` — dry-run by default, never duplicates on re-run. It stays in sync from there:
132
- `aidd tracker sync` diffs (or writes, with `--apply`) `tasks.md`'s Status column against live
133
- tracker status, and `aidd tracker link-pr` attaches an opened PR's URL back to its task's
134
- tracker issue and `tasks.md` row. CI templates for both trackers ship under
135
- `skill/templates/ci/`, installed with `aidd ci install {github,azure-devops}`.
136
- - **Has a package-install mechanism, kept to the load-bearing parts — not yet a third-party
137
- ecosystem.** `catalog/` is the marketplace *mechanism*: packages (templates, agent adapters,
138
- issue-tracker providers, hooks) install into *your* project with `aidd marketplace install
139
- <id>`, content-hashed so `remove` never discards a file you hand-edited since. A
140
- `provider`/`adapter`/`hook` package lands under `.aidd/extensions/<id>/` and is
141
- auto-discovered from there — no code change to this repo needed to use it. Structural
142
- validation runs in CI on every submission; a maintainer still reviews and merges each one by
143
- hand — see `catalog/README.md`. Today that catalog holds exactly one package, first-party
144
- (`hotfix-report`); zero third-party submissions have been merged yet — the mechanism is built
145
- and tested, the ecosystem it's built for doesn't exist yet. Manage what's discovered
146
- (first-party or project-local) with `aidd extensions list|info <id>|enable <id>|disable <id>`
147
- — see [`docs/EXTENDING.md`](docs/EXTENDING.md).
148
-
149
- ## What's in this repo
150
-
151
- - **`skill/`** — the Claude Code skill: `SKILL.md`, enforcement hooks (`hooks/`: ten by default, centred on the single `rule_gate.py`), and every
152
- script/template (`scripts/`, `templates/`). `skill/AIDD.md` is the tool-agnostic methodology
153
- core every other adapter — including this repo's own CLI — points back to. Includes AIDD Memory
154
- (`scripts/aidd_memory.py`, `aidd_memory_import.py`; hooks `memory_context.py`,
155
- `memory_file_context.py`, opt-in via `install_hooks.py --with-memory-file-hook`).
156
- - **`aidd/`** — the CLI (`pip install -e .` → the `aidd` command): a thin dispatcher over
157
- `skill/scripts/`, for a human at a terminal or a CI job, no AI agent required.
158
- - **`commands/`** — the eight `/aidd-*` pipeline-stage commands for Claude Code.
159
- - **`adapters/`** — drop-in adapters for other agent tools (OpenCode skill + plugin, an
160
- `AGENTS.md` snippet for Codex and others, a `GEMINI.md` pointer) plus `dot-aidd/`, the portable
161
- `.aidd/` bundle (methodology + scripts + templates, no Claude-specific pieces) any project
162
- installs once and every adapter reads from. See `adapters/README.md` for the install steps.
163
- - **`catalog/`** — the marketplace mechanism: `schema.json`, two registries (`catalog.json`
164
- first-party, currently one package; `catalog.community.json` third-party, currently empty),
165
- and `packages/<id>/` folders. Installed/searched via `skill/scripts/marketplace.py` (or `aidd
166
- marketplace ...`), validated in CI by `skill/scripts/validate_catalog_entry.py`. See
167
- `catalog/README.md` and `catalog/CONTRIBUTING.md`.
168
- - **`tests/`** — the stdlib `unittest` suite (zero dependencies, `python -m unittest discover -s
169
- tests`), run on every push/PR by `.github/workflows/test.yml` (and `catalog-validate.yml` for
170
- anything touching `catalog/`).
171
-
172
- ## Install (Claude Code)
173
-
174
- ```bash
175
- cp -r skill ~/.claude/skills/aidd
176
- python ~/.claude/skills/aidd/scripts/install_hooks.py
177
- ```
178
-
179
- ## Install (the CLI — for a terminal or CI, no AI agent needed)
180
-
181
- ```bash
182
- pip install aidd-cli
183
- aidd init /path/to/your/project # installs the .aidd/ bundle there
184
- aidd search "login" # search the spec graph
185
- aidd check specs/001-login/ # mechanical gap-check
186
- aidd check-charter . # run charter.md's checkable rules
187
- aidd status # hard-rules ledger of all open specs + WHY blocked (--json; exit 0 always)
188
- aidd rules check specs/001-login/ # PASS|FAIL Rn message -> fix (exit 1 on a violation)
189
- aidd rules approve specs/001-login/ # write the tasks.md Approved: line (needs the user's recorded "Approve" answer)
190
- aidd rules close 001-login # complete the spec (needs approval + qa-audit + auditors + the user's "Yes, close" answer)
191
- aidd rules abandon 001-login # drop it (needs the user's recorded "Abandon" answer)
192
- aidd flow specs/001-login/visual-flow.toon --open # Flowmap: interactive flow + pseudocode
193
- aidd mem add --type decision --title "Login uses magic links" --why "No password storage" --codes US-001,API-003 --scope 001-login
194
- aidd mem search login # one line per hit: id, date, type, codes, title
195
- aidd mem show m-3fa91c02 # full entry (why, files, supersedes)
196
- aidd mem timeline m-3fa91c02 # neighbouring entries of the same scope, by date
197
- aidd mem file skill/scripts/flowmap.py # entries that mention a file
198
- aidd mem inject # the digest the SessionStart hook injects (also: inject --file PATH)
199
- aidd mem stats # counts by type/scope, bytes
200
- aidd mem compact --before 2026-07-01 --apply # archive superseded/old entries (dry run without --apply)
201
- aidd mem import-claude-mem <claude-mem.db> --project myproj --since 2026-01-01 --dry-run # one-off, read-only import (also --scope, --include, --no-summaries)
202
- # AIDD_MEMORY_DIR overrides .aidd/memory/; `aidd mem --root X <cmd>` works before or after the command; `add --date` backdates
203
- aidd tasks-to-issues specs/001-login/tasks.md --apply # sync tasks (github by default)
204
- aidd tasks-to-issues specs/001-login/tasks.md --provider azure_devops --org ... --project ... --apply
205
- aidd adapters generate all /path/to/your/project # native commands for Gemini CLI, Cursor, Windsurf, Cline, Copilot
206
- aidd marketplace list # browse installable third-party packages
207
- aidd marketplace install hotfix-report /path/to/your/project
208
- aidd extensions list # discovered provider/adapter/hook extensions
209
- aidd tracker sync specs/001-login/tasks.md --provider github --repo owner/repo # dry-run status diff
210
- aidd tracker link-pr specs/001-login/tasks.md --pr-url ... --branch ... --apply
211
- aidd ci install github /path/to/your/project # install the GitHub Actions CI template
212
- ```
213
-
214
- Published on PyPI as [`aidd-cli`](https://pypi.org/project/aidd-cli/). To work on AIDD itself
215
- instead of just using it, clone and install in editable mode:
216
-
217
- ```bash
218
- git clone https://github.com/quimhen/aidd.git && cd aidd
219
- pip install -e .
220
- ```
221
-
222
- ## Install (other tools)
223
-
224
- See `adapters/README.md`.
225
-
226
- ## Documentation
227
-
228
- - [**Why AIDD**](docs/WHY-AIDD.md) — what changes for you, in plain language, with the measured
229
- numbers.
230
- - [**Pipeline reference**](docs/PIPELINE.md) — the full technical breakdown: the code system, the
231
- spec graph, every step, the enforcement hooks.
232
- - [**FAQ**](docs/FAQ.md) — common questions. Have one that's not there? Open an
233
- [issue](../../issues) or a [discussion](../../discussions).
234
- - [**Extending AIDD**](docs/EXTENDING.md) — the three extension seams (issue tracker
235
- providers and multi-agent adapter targets, both auto-discovered from
236
- `skill/extensions/**/manifest.json` or `.aidd/extensions/**/manifest.json`, plus
237
- charter checkable rules), and how they relate to the marketplace (`catalog/`).
238
- - [**Consulting**](docs/CONSULTING.md) — if your team wants help adopting AIDD.
239
-
240
- ## Status
241
-
242
- Early — the core pipeline, the search/graph tools, the charter checker, the graph-coherence
243
- gate, the issue-tracker sync (GitHub/Azure DevOps/Bitbucket, plus bidirectional status sync
244
- via `aidd tracker sync` and PR<->task linking via `aidd tracker link-pr`), CI templates and
245
- `aidd ci install`, the Claude Code hooks (ten by default, plus an opt-in per-file memory hook; one `rule_gate.py` enforcing hard rules R1–R12
246
- including the independent-audit and graph-coherence gates, and a `stop_gate.py`), the evidence log, `aidd status`/`aidd rules`, the multi-agent adapter generator (`generate_adapters.py`, rendering
247
- Gemini CLI/Cursor/Windsurf/Cline/Copilot commands from one source), the real auto-discovery
248
- extension registry (`extension_registry.py`, loading provider/adapter/hook extensions from
249
- `skill/extensions/**/manifest.json` and `.aidd/extensions/**/manifest.json` — see
250
- `docs/EXTENDING.md`), and the marketplace (`catalog/` + `marketplace.py` +
251
- `validate_catalog_entry.py`, one first-party package shipped so far: `hotfix-report`) are built,
252
- tested (stdlib `unittest`, run in CI), and have been run against a real production
253
- codebase. OpenCode, Codex, and the five generated adapter targets follow the same methodology;
254
- only the Claude Code hooks currently give it technical teeth. Published on PyPI as `aidd-cli`.
255
- The marketplace is intentionally not a fully automated accept path: CI validates structure and
256
- flags anything worth a human's attention, but a maintainer reviews and merges every catalog
257
- submission by hand — see `catalog/README.md`.
258
-
259
- ## Support this project
260
-
261
- If AIDD saves your agent sessions real time, [sponsor it on GitHub](https://github.com/sponsors/quimhen)
262
- — it funds the time spent maintaining the pipeline, the hooks, and the multi-agent adapters.
263
-
264
- ## License
265
-
266
- MIT — see [LICENSE](LICENSE).
1
+ <div align="center">
2
+
3
+ # ⚡ AIDD — AI-Driven Development
4
+ ### Stop AI coding agents from grading their own homework.
5
+
6
+ [![PyPI version](https://img.shields.io/pypi/v/aidd-cli.svg?color=blue)](https://pypi.org/project/aidd-cli/)
7
+ [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
8
+ [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/)
9
+ [![Tested on Claude Code](https://img.shields.io/badge/Enforced_on-Claude_Code-purple.svg)](https://claude.ai)
10
+ [![Sponsor](https://img.shields.io/badge/sponsor-%E2%9D%A4-db61a2)](https://github.com/sponsors/quimhen)
11
+
12
+ **A methodology with technical teeth for AI coding agents (Claude Code, OpenCode, Codex, Gemini CLI).**
13
+ It forces agents to search before creating, plan out loud before coding, and blocks self-approval
14
+ via automated hooks — not another AI coding agent itself, a set of habits your existing one follows.
15
+
16
+ [Explore Landing](https://aidd-landing.vercel.app/) · [Why AIDD](docs/WHY-AIDD.md) · [Pipeline Docs](docs/PIPELINE.md) · [Report Bug](https://github.com/quimhen/aidd/issues)
17
+
18
+ </div>
19
+
20
+ ---
21
+
22
+ ### 🚀 10-Second Quick Start
23
+
24
+ Get started in any existing repository without modifying your code:
25
+
26
+ ```bash
27
+ # 1. Install the CLI
28
+ pip install aidd-cli
29
+
30
+ # 2. Initialize in your project
31
+ aidd init .
32
+
33
+ # 3. Check for architectural violations & spec gaps
34
+ aidd check-charter .
35
+ aidd search "auth flow"
36
+ ```
37
+
38
+ > **Using Claude Code?** Install the technical enforcement gates with one command:
39
+ > ```bash
40
+ > cp -r skill ~/.claude/skills/aidd && python ~/.claude/skills/aidd/scripts/install_hooks.py
41
+ > ```
42
+
43
+ <div align="center">
44
+ <img src="docs/assets/demo-terminal.svg" alt="AIDD hook blocking a self-approved PR, then dispatching an independent QA subagent" width="760" />
45
+ </div>
46
+
47
+ ---
48
+
49
+ ### ⚖️ Why AIDD vs. traditional prompts / spec files
50
+
51
+ | Feature | Traditional rules (`CLAUDE.md`, `.cursorrules`) | AIDD methodology |
52
+ | :--- | :--- | :--- |
53
+ | **Compliance** | Optional (LLMs tend to skip long instructions) | **Strict / blocking** (real system hooks) |
54
+ | **Code review** | The same agent grades its own code | **Independent subagent audit, mandatory** |
55
+ | **UI mapping** | Duplicated, per-screen prose | **Unified codes** (`COMP-nnn`, `CTL-nnn`) |
56
+ | **Task tracking** | Disconnected markdown nobody re-checks | **Bidirectional sync** with GitHub / Azure DevOps / Bitbucket |
57
+ | **Context cost** | Dumps thousands of tokens into every prompt | **Indexed local lookup** (`find_spec.py`) |
58
+
59
+ ## The problem
60
+
61
+ AI coding agents are fast at writing code and bad at knowing what already exists. Left alone, they
62
+ duplicate specs nobody asked for, re-explain a flow in three paragraphs instead of drawing it, ship
63
+ a fix that fabricates success instead of actually calling the real backend, and grade their own
64
+ homework when asked to review it. AIDD is the set of habits that stops that — enforced by hooks
65
+ where the tool allows it, followed as a written discipline everywhere else.
66
+
67
+ ## What it does
68
+
69
+ - **Searches before creating.** Every request runs against a compact, auto-built graph of every
70
+ existing spec (`specs/index.toon`) before anything new gets created — a match means "amend this,"
71
+ not "start over."
72
+ - **Shows the plan before building it.** Step 1.5 turns each use case into an interactive
73
+ actors × processes flow with generated pseudocode (`aidd flow specs/001-login/visual-flow.toon
74
+ --open`) — the user clicks through it and corrects the flow by node, not in prose. Source is
75
+ a compact TOON file; layout, routing and pseudocode are derived, never hand-drawn.
76
+ - **Plans out loud.** Ambiguity gets resolved as an explicit question before code is written, not
77
+ discovered after a review.
78
+ - **Ships in small, reviewable pieces.** One code, one file, one PR — a wrong pass costs one edit,
79
+ not a rewrite.
80
+ - **Never lets the implementer grade its own work.** Step 6's review must come from a separate
81
+ agent dispatch, one per domain the change touched. On Claude Code this is an actual technical
82
+ gate (`hooks/rule_gate.py` + `stop_gate.py`), not just a rule stated in a doc.
83
+ - **Enforces the rules instead of asking nicely.** Hard rules R1–R12: estimates are agent
84
+ minutes per wave (human hours only as a reference), skipping a step needs the user's quoted
85
+ confirmation (verified against what the user typed or answered), the agent can't answer its own
86
+ Align questions (blank answers block planning, `repo —` sources must exist and cite a line),
87
+ plan/tasks can't be written out of order, `tasks.md` approval is the user's recorded "Approve"
88
+ answer plus a tamper-evident hash, a spec stays open until `aidd rules close`/`abandon` (touching
89
+ another spec can't switch the gates off), code edits are blocked for every open spec without a
90
+ recorded approval, every required domain needs its own distinct auditor, and a session can't
91
+ end on built code without its closing audits (R8 relaxes after 3 blocks); a ✅ screen/API/field
92
+ needs executed evidence, not a code reading (R10, freshness best-effort), a repeated bug needs a
93
+ root cause and pattern sweep (R11), and a task that reuses a screen/component must say whether it is a
94
+ new view or logic only (R12). Hooks write an
95
+ append-only evidence log (guarded against the agent by R9: the Write/Edit tools and a lexical shell guard, not a sandbox) (per-session in the temp dir, plus a project log only where
96
+ a `specs/` or `.aidd/` root exists) that the gates read; `aidd status` lists every open spec with the
97
+ ledger and **WHY blocked**, and `aidd rules check` prints `PASS|FAIL Rn … → fix`.
98
+ Honest limits: Claude Code only; **Bash and PowerShell can still edit code** and, through the CLI or
99
+ libraries, try to forge evidence (the guard is lexical, not a sandbox); the gates check that a
100
+ subagent ran and a question was answered, not that they were good; the user's click cannot be
101
+ proven; hooks fail open on a crash, launch failure or timeout (recorded as `hook_error` when
102
+ possible); session ids/resume behaviour are not verified. The rules stop accidental and
103
+ self-justified skipping, not a determined agent. `AIDD_RULES=off|0|false|no|warn` is the
104
+ owner's escape hatch.
105
+ - **Remembers the why.** Decisions, rejected options, bug root causes and constraints go into
106
+ `.aidd/memory/` as curated, code-anchored AIDD-TOON entries, committed with the code — no
107
+ daemon, no LLM observer, no vectors, stdlib only. Search is progressive: `aidd mem search`
108
+ returns one line per hit, `aidd mem show <id>` the full row. On Claude Code `memory_context.py` surfaces
109
+ the relevant entries at session start (installed by default; the per-file `memory_file_context.py` is opt-in). `STATE.md` stays
110
+ "where am I", `specs/index.toon` stays "what exists"; memory is "why". A one-off, read-only
111
+ importer can seed it from a claude-mem database (secrets and IPs scrubbed). Memory is committed content that gets injected into sessions: review it like code.
112
+ - **Works the same across tools.** One methodology (`skill/AIDD.md`), thin adapters per tool — no
113
+ relearning the process when the assistant changes. For Claude Code, OpenCode, and Codex, that's
114
+ a native skill/AGENTS.md pointer; for Gemini CLI, Cursor, Windsurf, Cline, and GitHub Copilot,
115
+ `generate_adapters.py` renders each one's own native command-file format straight from
116
+ `commands/aidd-*.md` — one source, no per-agent copy to keep in sync. Both the issue-tracker
117
+ providers and these adapter targets are auto-discovered extensions (see
118
+ [`docs/EXTENDING.md`](docs/EXTENDING.md)), so a project can add its own without forking this repo.
119
+ - **Has a charter that's actually checked.** Project-wide rules split into judgment calls
120
+ (prose) and checkable ones (a pattern + glob table `check_charter.py` runs for real) — not
121
+ a principles doc trusted to memory. Run against a real production project, it caught two
122
+ stale claims in that project's own hand-written notes about specific libraries being unused
123
+ (both false, verified in seconds) and a third that turned out far worse than self-rated
124
+ (340 real violations of a rule logged as low-severity).
125
+ - **Verifies its own map before planning against it.** The spec graph is parsed mechanically
126
+ (fast, cheap), which also means it can misparse a renamed code or a stale relationship — so a
127
+ rebuild dispatches an independent Graph Coherence Auditor before `plan.md`/`tasks.md` build on
128
+ the new edges. Enforced by a hook pair, not a step an agent could skip under time pressure.
129
+ - **Syncs to GitHub, Azure DevOps, or Bitbucket — not just markdown.** An approved `tasks.md`
130
+ becomes real, trackable issues via `tasks_to_issues.py --provider {github,azure_devops,
131
+ bitbucket}` — dry-run by default, never duplicates on re-run. It stays in sync from there:
132
+ `aidd tracker sync` diffs (or writes, with `--apply`) `tasks.md`'s Status column against live
133
+ tracker status, and `aidd tracker link-pr` attaches an opened PR's URL back to its task's
134
+ tracker issue and `tasks.md` row. CI templates for both trackers ship under
135
+ `skill/templates/ci/`, installed with `aidd ci install {github,azure-devops}`.
136
+ - **Has a package-install mechanism, kept to the load-bearing parts — not yet a third-party
137
+ ecosystem.** `catalog/` is the marketplace *mechanism*: packages (templates, agent adapters,
138
+ issue-tracker providers, hooks) install into *your* project with `aidd marketplace install
139
+ <id>`, content-hashed so `remove` never discards a file you hand-edited since. A
140
+ `provider`/`adapter`/`hook` package lands under `.aidd/extensions/<id>/` and is
141
+ auto-discovered from there — no code change to this repo needed to use it. Structural
142
+ validation runs in CI on every submission; a maintainer still reviews and merges each one by
143
+ hand — see `catalog/README.md`. Today that catalog holds exactly one package, first-party
144
+ (`hotfix-report`); zero third-party submissions have been merged yet — the mechanism is built
145
+ and tested, the ecosystem it's built for doesn't exist yet. Manage what's discovered
146
+ (first-party or project-local) with `aidd extensions list|info <id>|enable <id>|disable <id>`
147
+ — see [`docs/EXTENDING.md`](docs/EXTENDING.md).
148
+
149
+ ## What's in this repo
150
+
151
+ - **`skill/`** — the Claude Code skill: `SKILL.md`, enforcement hooks (`hooks/`: ten by default, centred on the single `rule_gate.py`), and every
152
+ script/template (`scripts/`, `templates/`). `skill/AIDD.md` is the tool-agnostic methodology
153
+ core every other adapter — including this repo's own CLI — points back to. Includes AIDD Memory
154
+ (`scripts/aidd_memory.py`, `aidd_memory_import.py`; hooks `memory_context.py`,
155
+ `memory_file_context.py`, opt-in via `install_hooks.py --with-memory-file-hook`).
156
+ - **`aidd/`** — the CLI (`pip install -e .` → the `aidd` command): a thin dispatcher over
157
+ `skill/scripts/`, for a human at a terminal or a CI job, no AI agent required.
158
+ - **`commands/`** — the eight `/aidd-*` pipeline-stage commands for Claude Code.
159
+ - **`adapters/`** — drop-in adapters for other agent tools (OpenCode skill + plugin, an
160
+ `AGENTS.md` snippet for Codex and others, a `GEMINI.md` pointer) plus `dot-aidd/`, the portable
161
+ `.aidd/` bundle (methodology + scripts + templates, no Claude-specific pieces) any project
162
+ installs once and every adapter reads from. See `adapters/README.md` for the install steps.
163
+ - **`catalog/`** — the marketplace mechanism: `schema.json`, two registries (`catalog.json`
164
+ first-party, currently one package; `catalog.community.json` third-party, currently empty),
165
+ and `packages/<id>/` folders. Installed/searched via `skill/scripts/marketplace.py` (or `aidd
166
+ marketplace ...`), validated in CI by `skill/scripts/validate_catalog_entry.py`. See
167
+ `catalog/README.md` and `catalog/CONTRIBUTING.md`.
168
+ - **`tests/`** — the stdlib `unittest` suite (zero dependencies, `python -m unittest discover -s
169
+ tests`), run on every push/PR by `.github/workflows/test.yml` (and `catalog-validate.yml` for
170
+ anything touching `catalog/`).
171
+
172
+ ## Install (Claude Code)
173
+
174
+ ```bash
175
+ cp -r skill ~/.claude/skills/aidd
176
+ python ~/.claude/skills/aidd/scripts/install_hooks.py
177
+ ```
178
+
179
+ ## Install (the CLI — for a terminal or CI, no AI agent needed)
180
+
181
+ ```bash
182
+ pip install aidd-cli
183
+ aidd init /path/to/your/project # installs the .aidd/ bundle there
184
+ aidd search "login" # search the spec graph
185
+ aidd check specs/001-login/ # mechanical gap-check
186
+ aidd check-charter . # run charter.md's checkable rules
187
+ aidd status # hard-rules ledger of all open specs + WHY blocked (--json; exit 0 always)
188
+ aidd rules check specs/001-login/ # PASS|FAIL Rn message -> fix (exit 1 on a violation)
189
+ aidd rules approve specs/001-login/ # write the tasks.md Approved: line (needs the user's recorded "Approve" answer)
190
+ aidd rules close 001-login # complete the spec (needs approval + qa-audit + auditors + the user's "Yes, close" answer)
191
+ aidd rules abandon 001-login # drop it (needs the user's recorded "Abandon" answer)
192
+ aidd flow specs/001-login/visual-flow.toon --open # Flowmap: interactive flow + pseudocode
193
+ aidd mem add --type decision --title "Login uses magic links" --why "No password storage" --codes US-001,API-003 --scope 001-login
194
+ aidd mem search login # one line per hit: id, date, type, codes, title
195
+ aidd mem show m-3fa91c02 # full entry (why, files, supersedes)
196
+ aidd mem timeline m-3fa91c02 # neighbouring entries of the same scope, by date
197
+ aidd mem file skill/scripts/flowmap.py # entries that mention a file
198
+ aidd mem inject # the digest the SessionStart hook injects (also: inject --file PATH)
199
+ aidd mem stats # counts by type/scope, bytes
200
+ aidd mem compact --before 2026-07-01 --apply # archive superseded/old entries (dry run without --apply)
201
+ aidd mem import-claude-mem <claude-mem.db> --project myproj --since 2026-01-01 --dry-run # one-off, read-only import (also --scope, --include, --no-summaries)
202
+ # AIDD_MEMORY_DIR overrides .aidd/memory/; `aidd mem --root X <cmd>` works before or after the command; `add --date` backdates
203
+ aidd tasks-to-issues specs/001-login/tasks.md --apply # sync tasks (github by default)
204
+ aidd tasks-to-issues specs/001-login/tasks.md --provider azure_devops --org ... --project ... --apply
205
+ aidd adapters generate all /path/to/your/project # native commands for Gemini CLI, Cursor, Windsurf, Cline, Copilot
206
+ aidd marketplace list # browse installable third-party packages
207
+ aidd marketplace install hotfix-report /path/to/your/project
208
+ aidd extensions list # discovered provider/adapter/hook extensions
209
+ aidd tracker sync specs/001-login/tasks.md --provider github --repo owner/repo # dry-run status diff
210
+ aidd tracker link-pr specs/001-login/tasks.md --pr-url ... --branch ... --apply
211
+ aidd ci install github /path/to/your/project # install the GitHub Actions CI template
212
+ ```
213
+
214
+ Published on PyPI as [`aidd-cli`](https://pypi.org/project/aidd-cli/). To work on AIDD itself
215
+ instead of just using it, clone and install in editable mode:
216
+
217
+ ```bash
218
+ git clone https://github.com/quimhen/aidd.git && cd aidd
219
+ pip install -e .
220
+ ```
221
+
222
+ ## Install (other tools)
223
+
224
+ See `adapters/README.md`.
225
+
226
+ ## Documentation
227
+
228
+ - [**Why AIDD**](docs/WHY-AIDD.md) — what changes for you, in plain language, with the measured
229
+ numbers.
230
+ - [**Pipeline reference**](docs/PIPELINE.md) — the full technical breakdown: the code system, the
231
+ spec graph, every step, the enforcement hooks.
232
+ - [**FAQ**](docs/FAQ.md) — common questions. Have one that's not there? Open an
233
+ [issue](../../issues) or a [discussion](../../discussions).
234
+ - [**Extending AIDD**](docs/EXTENDING.md) — the three extension seams (issue tracker
235
+ providers and multi-agent adapter targets, both auto-discovered from
236
+ `skill/extensions/**/manifest.json` or `.aidd/extensions/**/manifest.json`, plus
237
+ charter checkable rules), and how they relate to the marketplace (`catalog/`).
238
+ - [**Consulting**](docs/CONSULTING.md) — if your team wants help adopting AIDD.
239
+
240
+ ## Status
241
+
242
+ Early — the core pipeline, the search/graph tools, the charter checker, the graph-coherence
243
+ gate, the issue-tracker sync (GitHub/Azure DevOps/Bitbucket, plus bidirectional status sync
244
+ via `aidd tracker sync` and PR<->task linking via `aidd tracker link-pr`), CI templates and
245
+ `aidd ci install`, the Claude Code hooks (ten by default, plus an opt-in per-file memory hook; one `rule_gate.py` enforcing hard rules R1–R12
246
+ including the independent-audit and graph-coherence gates, and a `stop_gate.py`), the evidence log, `aidd status`/`aidd rules`, the multi-agent adapter generator (`generate_adapters.py`, rendering
247
+ Gemini CLI/Cursor/Windsurf/Cline/Copilot commands from one source), the real auto-discovery
248
+ extension registry (`extension_registry.py`, loading provider/adapter/hook extensions from
249
+ `skill/extensions/**/manifest.json` and `.aidd/extensions/**/manifest.json` — see
250
+ `docs/EXTENDING.md`), and the marketplace (`catalog/` + `marketplace.py` +
251
+ `validate_catalog_entry.py`, one first-party package shipped so far: `hotfix-report`) are built,
252
+ tested (stdlib `unittest`, run in CI), and have been run against a real production
253
+ codebase. OpenCode, Codex, and the five generated adapter targets follow the same methodology;
254
+ only the Claude Code hooks currently give it technical teeth. Published on PyPI as `aidd-cli`.
255
+ The marketplace is intentionally not a fully automated accept path: CI validates structure and
256
+ flags anything worth a human's attention, but a maintainer reviews and merges every catalog
257
+ submission by hand — see `catalog/README.md`.
258
+
259
+ ## Support this project
260
+
261
+ If AIDD saves your agent sessions real time, [sponsor it on GitHub](https://github.com/sponsors/quimhen)
262
+ — it funds the time spent maintaining the pipeline, the hooks, and the multi-agent adapters.
263
+
264
+ ## License
265
+
266
+ MIT — see [LICENSE](LICENSE).
@@ -13,8 +13,8 @@ screen), and how to read one section of `AIDD.md` on demand. Check the install w
13
13
  ```
14
14
  python .aidd/scripts/find_spec.py <a few keywords describing the request, or a SCREEN-XX/CTL-nnn/COMP-nnn/API-nnn code>
15
15
  ```
16
- - Exit code 0 (match found) → this is an **amendment** to the top-ranked spec under `specs/`, not a new feature. Reopen it; never open a new `specs/[###-feature]/` folder for a follow-up, a fix, or a "phase 2" of something already specified.
17
- - Exit code 1 (no match) → safe to create a new spec, following `.aidd/AIDD.md`'s Step 0 onward.
16
+ - Exit code 0 → inspect the top candidate and relevant sources before classifying it as an amendment; ranking is not proof of a match.
17
+ - Exit code 1 → no candidate was found; this does not prove absence. Check relevant specs and naming variants before creating a new spec.
18
18
  - `python .aidd/scripts/find_spec.py --tree <spec-id>` prints that spec's real use-case → screen → component → control → API graph.
19
19
  - `python .aidd/scripts/check_spec.py specs/[###-feature]/` is a mechanical gap-checker — run it before a manual audit pass (Step 6).
20
20
 
@@ -26,3 +26,4 @@ Rules:
26
26
  - Shared-First & Component-Driven Development (CDD): eradicate code duplication (DRY), assume a shared component library/monorepo, favor Inversion of Control (Compound Components, slots), and structure UI requests in 3 sections: [AUDITORÍA DE REUTILIZACIÓN], [PROPUESTA DE COMPONENTE COMPARTIDO], [IMPLEMENTACIÓN LOCAL / EXTENSIÓN].
27
27
  - Templates for every artifact live in `.aidd/templates/`; copy the matching one for whatever step you're on instead of hand-writing table headers from scratch.
28
28
  - `specs/index.toon` is an auto-built, auto-invalidated search index — never hand-edit it; `find_spec.py` rebuilds it itself when a spec's files change.
29
+ - Verify several open specs in ONE pass (E12): `aidd verify --round <spec>... --dry-run` (plan and savings), freeze the code, `aidd verify --round <spec>...` (rows their own spec already passed on the same Scope, code, Inputs and environment identity are `REUSED`, not run — never a FAIL, never on an uncomputable fingerprint, never with `--full` or `Reuse: never`; every other identical row runs once, shared only on an unchanged environment fingerprint), then one round of auditors per spec. Spec by spec only when a single spec is ready.
@@ -1,16 +1,16 @@
1
- # AIDD
2
-
3
- This project uses AIDD (AI-Driven Development) as its default pipeline for any change: UI or
4
- backend-only, a new feature or a one-line fix.
5
-
6
- @.aidd/CORE.md
7
-
8
- The line above imports the short core (host detection, how to check the hard rules without hooks,
9
- the pipeline, what "done" means). Read it before planning or editing anything. Do NOT read
10
- `.aidd/AIDD.md` whole: it is ~120 KB and gets truncated; `CORE.md` section 6 shows how to read
11
- only the section you need.
12
-
13
- Gate missing or unsure? `aidd doctor --host gemini`; to install it: `aidd install --host gemini`.
14
-
15
- Before creating anything new: `python .aidd/scripts/find_spec.py <keywords>` and state
16
- `AIDD intake: NEW SPEC | AMENDMENT | AMENDMENT — Fast Lane — <reason>`.
1
+ # AIDD
2
+
3
+ This project uses AIDD (AI-Driven Development) as its default pipeline for any change: UI or
4
+ backend-only, a new feature or a one-line fix.
5
+
6
+ @.aidd/CORE.md
7
+
8
+ The line above imports the short core (host detection, how to check the hard rules without hooks,
9
+ the pipeline, what "done" means). Read it before planning or editing anything. Do NOT read
10
+ `.aidd/AIDD.md` whole: it is ~120 KB and gets truncated; `CORE.md` section 6 shows how to read
11
+ only the section you need.
12
+
13
+ Gate missing or unsure? `aidd doctor --host gemini`; to install it: `aidd install --host gemini`.
14
+
15
+ Before creating anything new: `python .aidd/scripts/find_spec.py <keywords>` and state
16
+ `AIDD intake: NEW SPEC | AMENDMENT | AMENDMENT — Fast Lane — <reason>`.