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.
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/MANIFEST.in +3 -3
- {aidd_cli-0.2.0/aidd_cli.egg-info → aidd_cli-0.5.0}/PKG-INFO +1 -1
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/README.md +266 -266
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/AGENTS.md.snippet +3 -2
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/GEMINI.md +16 -16
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/README.md +241 -241
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/antigravity/rules/aidd.md +29 -29
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/antigravity/skills/aidd/SKILL.md +30 -30
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/AIDD.md +708 -693
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/CORE.md +133 -120
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/hooks/_common.py +197 -197
- aidd_cli-0.5.0/adapters/dot-aidd/hooks/codex_patch.py +181 -0
- aidd_cli-0.5.0/adapters/dot-aidd/hooks/codex_subagent.py +63 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/hooks/host_adapter.py +696 -659
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/hooks/mark_agent_dispatch.py +169 -159
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/hooks/mark_code_edit.py +141 -139
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/hooks/record_dispatch_pre.py +57 -57
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/hooks/require_aidd.py +66 -66
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/hooks/require_graph_coherence_audit.py +150 -150
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/hooks/require_independent_audit.py +83 -83
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/hooks/rule_gate.py +2120 -1980
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_amendment_verify.py +489 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/aidd_calibrate.py +135 -135
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_close_ledger.py +340 -0
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_coverage.py +573 -0
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_doctor.py +656 -656
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_embed.py +44 -0
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_evidence.py +2446 -2257
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_gitignore.py +57 -0
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_graphs.py +189 -47
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_guard.py +729 -495
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/aidd_job.py +726 -726
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_memory.py +1379 -1379
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_memory_import.py +403 -378
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_navigator.py +196 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/aidd_next.py +230 -216
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_pending.py +173 -0
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_progress.py +510 -347
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_provider_attestation.py +526 -0
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_readiness.py +128 -0
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_red.py +279 -0
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_reuse.py +104 -0
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_review.py +1756 -1381
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/aidd_review_items.py +1042 -1042
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/aidd_review_state.py +627 -627
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_round.py +773 -0
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_rules.py +822 -39
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_source_shape.py +137 -0
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_sqlcheck.py +268 -220
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_status.py +4081 -0
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_sync.py +391 -0
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/aidd_tools.py +345 -337
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/aidd_triage.py +132 -132
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_unit_audit.py +795 -0
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_unit_consent.py +54 -0
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_unit_visual.py +240 -0
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/aidd_units.py +782 -0
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/alias_graph.py +153 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/check_charter.py +43 -11
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/check_spec.py +731 -699
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/code_graph.py +5 -5
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/component_graph.py +536 -536
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/find_spec.py +1315 -1284
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/flowmap.py +1542 -1541
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/graph_explorer.py +1644 -0
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/graph_snapshot.py +1098 -1098
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/graph_trace.py +733 -733
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/method_graph.py +297 -297
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/sql_graph.py +1125 -1125
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/scripts/tasks_to_issues.py +283 -283
- aidd_cli-0.5.0/adapters/dot-aidd/scripts/unified_graph.py +405 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/STATE.md +41 -41
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/calibration.toon +6 -6
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/templates/charter.md +1 -1
- aidd_cli-0.5.0/adapters/dot-aidd/templates/gitignore.aidd +9 -0
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/templates/mockup-audit.md +10 -0
- aidd_cli-0.5.0/adapters/dot-aidd/templates/navigator.html +32 -0
- aidd_cli-0.5.0/adapters/dot-aidd/templates/perf/README.md +22 -0
- aidd_cli-0.5.0/adapters/dot-aidd/templates/perf/plan-risk.test.sql +72 -0
- aidd_cli-0.5.0/adapters/dot-aidd/templates/perf/seed-generate-series.sql +52 -0
- {aidd_cli-0.2.0/skill → aidd_cli-0.5.0/adapters/dot-aidd}/templates/qa-audit.md +83 -83
- aidd_cli-0.5.0/adapters/dot-aidd/templates/review.html +1288 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/spec.md +20 -3
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/tasks.md +102 -102
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/opencode/plugins/aidd.js +116 -116
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/opencode/skills/aidd/SKILL.md +33 -33
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/aidd/__init__.py +10 -10
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/aidd/cli.py +730 -619
- {aidd_cli-0.2.0 → aidd_cli-0.5.0/aidd_cli.egg-info}/PKG-INFO +1 -1
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/aidd_cli.egg-info/SOURCES.txt +56 -61
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/pyproject.toml +38 -38
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/setup.py +32 -32
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/AIDD.md +708 -693
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/SKILL.md +553 -501
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/hooks/_common.py +197 -197
- aidd_cli-0.5.0/skill/hooks/codex_patch.py +181 -0
- aidd_cli-0.5.0/skill/hooks/codex_subagent.py +63 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/graph_refresh.py +98 -98
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/host_adapter.py +696 -659
- aidd_cli-0.5.0/skill/hooks/mark_agent_dispatch.py +169 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/mark_code_edit.py +141 -139
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/mark_user_question.py +22 -1
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/prompt_trigger.py +330 -330
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/read_hint.py +295 -295
- aidd_cli-0.5.0/skill/hooks/record_dispatch_pre.py +57 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/require_aidd.py +66 -66
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/hooks/require_graph_coherence_audit.py +150 -150
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/hooks/require_independent_audit.py +83 -83
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/hooks/rule_gate.py +2120 -1980
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/session_start.py +67 -67
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/stop_gate.py +274 -274
- aidd_cli-0.5.0/skill/hooks/tool_first_hint.py +284 -0
- aidd_cli-0.5.0/skill/scripts/aidd_amendment_verify.py +489 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/aidd_calibrate.py +135 -135
- aidd_cli-0.5.0/skill/scripts/aidd_close_ledger.py +340 -0
- aidd_cli-0.5.0/skill/scripts/aidd_coverage.py +573 -0
- aidd_cli-0.5.0/skill/scripts/aidd_doctor.py +656 -0
- aidd_cli-0.5.0/skill/scripts/aidd_embed.py +44 -0
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_evidence.py +2446 -2257
- aidd_cli-0.5.0/skill/scripts/aidd_gitignore.py +57 -0
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_graphs.py +189 -47
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_guard.py +729 -495
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/aidd_job.py +726 -726
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_memory.py +1379 -1379
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_memory_import.py +403 -378
- aidd_cli-0.5.0/skill/scripts/aidd_navigator.py +196 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/aidd_next.py +230 -216
- aidd_cli-0.5.0/skill/scripts/aidd_pending.py +173 -0
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_progress.py +510 -347
- aidd_cli-0.5.0/skill/scripts/aidd_provider_attestation.py +526 -0
- aidd_cli-0.5.0/skill/scripts/aidd_readiness.py +128 -0
- aidd_cli-0.5.0/skill/scripts/aidd_red.py +279 -0
- aidd_cli-0.5.0/skill/scripts/aidd_reuse.py +104 -0
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_review.py +1756 -1381
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/aidd_review_items.py +1042 -1042
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/aidd_review_state.py +627 -627
- aidd_cli-0.5.0/skill/scripts/aidd_round.py +773 -0
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_rules.py +822 -39
- aidd_cli-0.5.0/skill/scripts/aidd_source_shape.py +137 -0
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_sqlcheck.py +268 -220
- aidd_cli-0.5.0/skill/scripts/aidd_status.py +4081 -0
- aidd_cli-0.5.0/skill/scripts/aidd_sync.py +391 -0
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/aidd_tools.py +345 -337
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/aidd_triage.py +132 -132
- aidd_cli-0.5.0/skill/scripts/aidd_unit_audit.py +795 -0
- aidd_cli-0.5.0/skill/scripts/aidd_unit_consent.py +54 -0
- aidd_cli-0.5.0/skill/scripts/aidd_unit_visual.py +240 -0
- aidd_cli-0.5.0/skill/scripts/aidd_units.py +782 -0
- aidd_cli-0.5.0/skill/scripts/alias_graph.py +153 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/check_charter.py +43 -11
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/check_spec.py +731 -699
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/code_graph.py +5 -5
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/component_graph.py +536 -536
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/find_spec.py +1315 -1284
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/flowmap.py +1542 -1541
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/generate_adapters.py +221 -221
- aidd_cli-0.5.0/skill/scripts/graph_explorer.py +1644 -0
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/graph_snapshot.py +1098 -1098
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/graph_trace.py +733 -733
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/install_hooks.py +263 -261
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/install_host.py +740 -732
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/marketplace.py +262 -262
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/method_graph.py +297 -297
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/research_project.py +6 -9
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/sql_graph.py +1125 -1125
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/scripts/tasks_to_issues.py +283 -283
- aidd_cli-0.5.0/skill/scripts/unified_graph.py +405 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/STATE.md +41 -41
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/calibration.toon +6 -6
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/templates/charter.md +1 -1
- aidd_cli-0.5.0/skill/templates/gitignore.aidd +9 -0
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/templates/mockup-audit.md +10 -0
- aidd_cli-0.5.0/skill/templates/navigator.html +32 -0
- aidd_cli-0.5.0/skill/templates/perf/README.md +22 -0
- aidd_cli-0.5.0/skill/templates/perf/plan-risk.test.sql +72 -0
- aidd_cli-0.5.0/skill/templates/perf/seed-generate-series.sql +52 -0
- {aidd_cli-0.2.0/adapters/dot-aidd → aidd_cli-0.5.0/skill}/templates/qa-audit.md +83 -83
- aidd_cli-0.5.0/skill/templates/review.html +1288 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/spec.md +20 -3
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/tasks.md +107 -107
- aidd_cli-0.2.0/adapters/dot-aidd/scripts/aidd_pending.py +0 -82
- aidd_cli-0.2.0/adapters/dot-aidd/scripts/aidd_status.py +0 -2020
- aidd_cli-0.2.0/adapters/dot-aidd/scripts/graph_explorer.py +0 -207
- aidd_cli-0.2.0/adapters/dot-aidd/templates/review.html +0 -551
- aidd_cli-0.2.0/skill/scripts/aidd_pending.py +0 -82
- aidd_cli-0.2.0/skill/scripts/aidd_status.py +0 -2020
- aidd_cli-0.2.0/skill/scripts/graph_explorer.py +0 -207
- aidd_cli-0.2.0/skill/templates/review.html +0 -551
- aidd_cli-0.2.0/tests/test_aidd_calibrate.py +0 -165
- aidd_cli-0.2.0/tests/test_aidd_graphs.py +0 -220
- aidd_cli-0.2.0/tests/test_aidd_guard.py +0 -461
- aidd_cli-0.2.0/tests/test_aidd_job.py +0 -249
- aidd_cli-0.2.0/tests/test_aidd_memory.py +0 -825
- aidd_cli-0.2.0/tests/test_aidd_memory_import.py +0 -398
- aidd_cli-0.2.0/tests/test_aidd_next.py +0 -166
- aidd_cli-0.2.0/tests/test_aidd_progress.py +0 -141
- aidd_cli-0.2.0/tests/test_aidd_review.py +0 -1437
- aidd_cli-0.2.0/tests/test_aidd_review_items.py +0 -1006
- aidd_cli-0.2.0/tests/test_aidd_review_state.py +0 -681
- aidd_cli-0.2.0/tests/test_aidd_rules.py +0 -2469
- aidd_cli-0.2.0/tests/test_aidd_rules_r10.py +0 -394
- aidd_cli-0.2.0/tests/test_aidd_sqlcheck.py +0 -106
- aidd_cli-0.2.0/tests/test_aidd_status.py +0 -2532
- aidd_cli-0.2.0/tests/test_aidd_tools.py +0 -174
- aidd_cli-0.2.0/tests/test_aidd_triage.py +0 -133
- aidd_cli-0.2.0/tests/test_check_charter.py +0 -151
- aidd_cli-0.2.0/tests/test_check_spec.py +0 -411
- aidd_cli-0.2.0/tests/test_cli_mem.py +0 -44
- aidd_cli-0.2.0/tests/test_cli_rules.py +0 -204
- aidd_cli-0.2.0/tests/test_code_fingerprint.py +0 -187
- aidd_cli-0.2.0/tests/test_code_graph.py +0 -252
- aidd_cli-0.2.0/tests/test_component_graph.py +0 -279
- aidd_cli-0.2.0/tests/test_dot_aidd_mirror.py +0 -521
- aidd_cli-0.2.0/tests/test_evidence.py +0 -1632
- aidd_cli-0.2.0/tests/test_extension_providers.py +0 -427
- aidd_cli-0.2.0/tests/test_find_spec.py +0 -686
- aidd_cli-0.2.0/tests/test_flowmap.py +0 -102
- aidd_cli-0.2.0/tests/test_generate_adapters.py +0 -202
- aidd_cli-0.2.0/tests/test_graph_explorer.py +0 -114
- aidd_cli-0.2.0/tests/test_graph_refresh_hook.py +0 -135
- aidd_cli-0.2.0/tests/test_graph_snapshot.py +0 -409
- aidd_cli-0.2.0/tests/test_graph_trace_method.py +0 -371
- aidd_cli-0.2.0/tests/test_graphs_auto.py +0 -113
- aidd_cli-0.2.0/tests/test_hooks.py +0 -1309
- aidd_cli-0.2.0/tests/test_host_doctor.py +0 -480
- aidd_cli-0.2.0/tests/test_host_gates.py +0 -1036
- aidd_cli-0.2.0/tests/test_host_install.py +0 -640
- aidd_cli-0.2.0/tests/test_install_ci.py +0 -108
- aidd_cli-0.2.0/tests/test_install_hooks.py +0 -311
- aidd_cli-0.2.0/tests/test_link_pr_to_task.py +0 -196
- aidd_cli-0.2.0/tests/test_marketplace.py +0 -280
- aidd_cli-0.2.0/tests/test_memory_hooks.py +0 -155
- aidd_cli-0.2.0/tests/test_perf_budget.py +0 -263
- aidd_cli-0.2.0/tests/test_prompt_trigger.py +0 -244
- aidd_cli-0.2.0/tests/test_r14.py +0 -295
- aidd_cli-0.2.0/tests/test_r9_transcript.py +0 -64
- aidd_cli-0.2.0/tests/test_read_hint.py +0 -234
- aidd_cli-0.2.0/tests/test_research_project.py +0 -110
- aidd_cli-0.2.0/tests/test_review_template.py +0 -695
- aidd_cli-0.2.0/tests/test_rule_gate.py +0 -2837
- aidd_cli-0.2.0/tests/test_rule_gate_shell_speed.py +0 -404
- aidd_cli-0.2.0/tests/test_sql_graph.py +0 -249
- aidd_cli-0.2.0/tests/test_sql_graph_incremental.py +0 -270
- aidd_cli-0.2.0/tests/test_stop_gate.py +0 -452
- aidd_cli-0.2.0/tests/test_sync_issues.py +0 -167
- aidd_cli-0.2.0/tests/test_tasks_to_issues.py +0 -185
- aidd_cli-0.2.0/tests/test_transcript_sync.py +0 -313
- aidd_cli-0.2.0/tests/test_typed_confirmations.py +0 -305
- aidd_cli-0.2.0/tests/test_validate_catalog_entry.py +0 -185
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/LICENSE +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/extensions/azure_devops/manifest.json +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/extensions/azure_devops/provider.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/extensions/bitbucket/manifest.json +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/extensions/bitbucket/provider.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/extensions/github/manifest.json +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/extensions/github/provider.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/extension_registry.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/link_pr_to_task.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/scripts/sync_issues.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/comprehensive-documentation.md +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/contracts.md +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/data-model.md +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/design-system/MASTER.md +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/design-system/components-index.md +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/design-system/page-override.md +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/plan.md +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/research.md +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/review-full.html +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/traceability.md +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/adapters/dot-aidd/templates/visual-flow.toon +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/aidd_cli.egg-info/dependency_links.txt +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/aidd_cli.egg-info/entry_points.txt +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/aidd_cli.egg-info/top_level.txt +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/setup.cfg +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/adapters/cline/manifest.json +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/adapters/copilot/manifest.json +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/adapters/cursor/manifest.json +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/adapters/gemini/manifest.json +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/adapters/windsurf/manifest.json +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/azure_devops/manifest.json +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/azure_devops/provider.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/bitbucket/manifest.json +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/bitbucket/provider.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/github/manifest.json +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/extensions/github/provider.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/mark_graph_rebuild.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/mark_invoked.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/memory_context.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/hooks/memory_file_context.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/extension_registry.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/install_ci.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/link_pr_to_task.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/sync_issues.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/scripts/validate_catalog_entry.py +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/ci/azure-pipelines-aidd.yml +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/ci/github-actions-aidd.yml +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/comprehensive-documentation.md +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/contracts.md +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/data-model.md +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/design-system/MASTER.md +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/design-system/components-index.md +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/design-system/page-override.md +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/plan.md +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/research.md +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/review-full.html +0 -0
- {aidd_cli-0.2.0 → aidd_cli-0.5.0}/skill/templates/traceability.md +0 -0
- {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,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
|
-
[](https://pypi.org/project/aidd-cli/)
|
|
7
|
-
[](LICENSE)
|
|
8
|
-
[](https://www.python.org/)
|
|
9
|
-
[](https://claude.ai)
|
|
10
|
-
[](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
|
+
[](https://pypi.org/project/aidd-cli/)
|
|
7
|
+
[](LICENSE)
|
|
8
|
+
[](https://www.python.org/)
|
|
9
|
+
[](https://claude.ai)
|
|
10
|
+
[](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
|
|
17
|
-
- Exit code 1
|
|
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>`.
|