framework-aidf 0.0.0-stage → 0.2.0
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.
- package/CHANGELOG.md +174 -0
- package/INSTALLATION.md +140 -0
- package/LICENSE +21 -0
- package/QODER.md +88 -0
- package/README.md +142 -2
- package/UTILISATION.md +188 -0
- package/assets/adapters/qoder/agents/aidf-orchestrator.md +30 -0
- package/assets/adapters/qoder/rules/00-core.md +28 -0
- package/assets/adapters/qoder/rules/10-security.md +33 -0
- package/assets/adapters/qoder/rules/20-context.md +39 -0
- package/assets/core/AGENTS.fragment.md +18 -0
- package/assets/core/AIDF.md +107 -0
- package/assets/docs/APPFLOW.md +66 -0
- package/assets/docs/BACKEND.md +71 -0
- package/assets/docs/CHANGELOG.md +25 -0
- package/assets/docs/CONVENTIONS.md +95 -0
- package/assets/docs/DECISIONS.md +60 -0
- package/assets/docs/PLAN.md +53 -0
- package/assets/docs/PRD.md +88 -0
- package/assets/docs/SECURITY.md +94 -0
- package/assets/docs/TRD.md +78 -0
- package/assets/docs/UI-UX.md +71 -0
- package/assets/docs/constitution.md +86 -0
- package/assets/hooks/audit.mjs +45 -0
- package/assets/hooks/session-context.mjs +53 -0
- package/assets/integrations/spec-kit/mapping.yaml +92 -0
- package/assets/knowledge/best-practices/testing.md +53 -0
- package/assets/knowledge/best-practices/web-dev-baseline.md +39 -0
- package/assets/knowledge/rules/api.md +45 -0
- package/assets/knowledge/rules/sql.md +44 -0
- package/assets/knowledge/rules/typescript.md +50 -0
- package/assets/knowledge/security-references/owasp-baseline.md +58 -0
- package/assets/registry/activation-map.yaml +83 -0
- package/assets/registry/dependencies.yaml +35 -0
- package/assets/registry/skills.yaml +541 -0
- package/assets/registry/sources.yaml +396 -0
- package/assets/schemas/architecture/v1.json +110 -0
- package/assets/schemas/constraints/v1.json +93 -0
- package/assets/schemas/decision/v1.json +106 -0
- package/assets/schemas/discovery/v1.json +91 -0
- package/assets/schemas/requirement/v1.json +136 -0
- package/assets/schemas/security/threat-model/v1.json +127 -0
- package/assets/schemas/test-plan/v1.json +108 -0
- package/assets/skills/aidf-architecture-review/SKILL.md +49 -0
- package/assets/skills/aidf-backend-implementation/SKILL.md +47 -0
- package/assets/skills/aidf-database-design/SKILL.md +48 -0
- package/assets/skills/aidf-devops-engineering/SKILL.md +41 -0
- package/assets/skills/aidf-documentation-maintenance/SKILL.md +41 -0
- package/assets/skills/aidf-frontend-implementation/SKILL.md +44 -0
- package/assets/skills/aidf-phase-transition/SKILL.md +48 -0
- package/assets/skills/aidf-product-analysis/SKILL.md +47 -0
- package/assets/skills/aidf-project-context/SKILL.md +57 -0
- package/assets/skills/aidf-requirements-engineering/SKILL.md +52 -0
- package/assets/skills/aidf-security-review/SKILL.md +57 -0
- package/assets/skills/aidf-testing-validation/SKILL.md +48 -0
- package/assets/skills/aidf-ui-ux-implementation/SKILL.md +43 -0
- package/assets/workflows/gates.yaml +232 -0
- package/assets/workflows/phases.yaml +161 -0
- package/bin/aidf.mjs +12 -0
- package/demo/run-demo.mjs +97 -0
- package/docs/aidf/ADR-001-artefacts-architectur.md +126 -0
- package/docs/aidf/ADR-002-requirements-registry.md +145 -0
- package/docs/aidf/ADR-003-traceability-chain.md +145 -0
- package/docs/aidf/ADR-004-markdown-generation.md +134 -0
- package/docs/aidf/ADR-005-validation-and-tests.md +170 -0
- package/docs/aidf/ADR-006-cli-commands.md +189 -0
- package/docs/aidf/ADR-007-compatibility-and-migration.md +119 -0
- package/docs/aidf/ADR-008-schema-versioning.md +115 -0
- package/docs/aidf/ADR-009-artefacts-scope.md +84 -0
- package/docs/aidf/ARCHITECTURE.md +137 -0
- package/docs/aidf/COMPATIBILITY.md +90 -0
- package/docs/aidf/DECISIONS.md +200 -0
- package/docs/aidf/FRAMEWORK.md +38 -0
- package/docs/aidf/IDE-QODER.md +61 -0
- package/docs/aidf/INSTALL.md +99 -0
- package/docs/aidf/INVENTORY.md +72 -0
- package/docs/aidf/L1-ARCHITECTURE-RAPPORT.md +353 -0
- package/docs/aidf/LIMITATIONS.md +69 -0
- package/docs/aidf/MATRICE-0.1.0-vers-0.2.0.md +155 -0
- package/docs/aidf/SECURITY.md +86 -0
- package/docs/aidf/SKILLS.md +78 -0
- package/docs/aidf/SPECKIT.md +67 -0
- package/docs/aidf/USAGE.md +113 -0
- package/docs/aidf/VALIDATION.md +55 -0
- package/package.json +37 -4
- package/src/cli.mjs +148 -0
- package/src/commands/artefacts.mjs +129 -0
- package/src/commands/config.mjs +130 -0
- package/src/commands/context.mjs +55 -0
- package/src/commands/decision.mjs +142 -0
- package/src/commands/design.mjs +141 -0
- package/src/commands/docs.mjs +133 -0
- package/src/commands/doctor.mjs +210 -0
- package/src/commands/evidence.mjs +178 -0
- package/src/commands/install.mjs +154 -0
- package/src/commands/release.mjs +214 -0
- package/src/commands/requirements.mjs +196 -0
- package/src/commands/resources.mjs +181 -0
- package/src/commands/scan.mjs +139 -0
- package/src/commands/security.mjs +97 -0
- package/src/commands/setup.mjs +68 -0
- package/src/commands/skills.mjs +204 -0
- package/src/commands/speckit.mjs +78 -0
- package/src/commands/tests.mjs +81 -0
- package/src/commands/traceability.mjs +116 -0
- package/src/commands/uninstall.mjs +238 -0
- package/src/commands/validate.mjs +84 -0
- package/src/commands/workflow.mjs +137 -0
- package/src/core/adapters/base.mjs +32 -0
- package/src/core/adapters/generic.mjs +70 -0
- package/src/core/adapters/index.mjs +24 -0
- package/src/core/adapters/opencode.mjs +115 -0
- package/src/core/adapters/qoder.mjs +228 -0
- package/src/core/artefacts/index.mjs +1 -0
- package/src/core/artefacts/validation.mjs +161 -0
- package/src/core/bootstrap.mjs +179 -0
- package/src/core/config.mjs +123 -0
- package/src/core/context.mjs +187 -0
- package/src/core/design-engineering/complexity-classifier.mjs +78 -0
- package/src/core/design-engineering/engine.mjs +197 -0
- package/src/core/design-engineering/fallback/mockups.mjs +221 -0
- package/src/core/design-engineering/fallback/wireframes.mjs +114 -0
- package/src/core/design-engineering/figma/validators.mjs +178 -0
- package/src/core/design-engineering/index.mjs +9 -0
- package/src/core/design-engineering/visual-parity/capture.mjs +172 -0
- package/src/core/detect.mjs +220 -0
- package/src/core/docsgen.mjs +175 -0
- package/src/core/evidence.mjs +210 -0
- package/src/core/installer.mjs +377 -0
- package/src/core/manifest.mjs +53 -0
- package/src/core/paths.mjs +94 -0
- package/src/core/requirements/index.mjs +13 -0
- package/src/core/requirements/registry.mjs +234 -0
- package/src/core/resource-inventory.mjs +434 -0
- package/src/core/resources.mjs +280 -0
- package/src/core/security/threat-model.mjs +235 -0
- package/src/core/skills.mjs +353 -0
- package/src/core/source-skills.mjs +213 -0
- package/src/core/speckit.mjs +195 -0
- package/src/core/technology-decision/analyzer-deterministic.mjs +240 -0
- package/src/core/technology-decision/engine.mjs +157 -0
- package/src/core/technology-decision/generator.mjs +204 -0
- package/src/core/technology-decision/index.mjs +17 -0
- package/src/core/technology-decision/options/index.mjs +10 -0
- package/src/core/testplan.mjs +176 -0
- package/src/core/traceability/chain.mjs +488 -0
- package/src/core/traceability/index.mjs +12 -0
- package/src/core/workflow.mjs +471 -0
- package/src/util/args.mjs +69 -0
- package/src/util/frontmatter.mjs +26 -0
- package/src/util/fsx.mjs +208 -0
- package/src/util/logger.mjs +74 -0
- package/src/util/text.mjs +66 -0
- package/src/util/yaml.mjs +379 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to AIDF are documented here. This project does not use
|
|
4
|
+
conventional commits; each entry names real, verified behaviour changes.
|
|
5
|
+
|
|
6
|
+
## [0.2.0] — 2026-11-21
|
|
7
|
+
|
|
8
|
+
AIDF 0.2.0 turns the 0.1.0 governance base into a full engineering framework:
|
|
9
|
+
canonical artefacts with traceability, a deterministic technology decision
|
|
10
|
+
engine, design workflows with fallback mockups, resource and third-party
|
|
11
|
+
skill management, an OpenCode adapter with real runtime proof, a STRIDE
|
|
12
|
+
threat-model generator, test planning, generated documentation and a
|
|
13
|
+
release readiness report. Migration from 0.1.0 is additive and tested.
|
|
14
|
+
|
|
15
|
+
### Added (verified 2026-11-21)
|
|
16
|
+
- Resource Engine v2: `aidf resources inventory|coverage|reconcile` produce a
|
|
17
|
+
file-level sha256 manifest, a licence policy per resource, duplicate-skill
|
|
18
|
+
detection and lock/manifest drift reconciliation. Verified on the real
|
|
19
|
+
`resources/` corpus: 18 resources, 12 533 files, 81 SKILL.md (74 unique
|
|
20
|
+
AVAILABLE, 7 DUPLICATE), 23 secret-like paths skipped.
|
|
21
|
+
- Skills Engine v2: `aidf skills sources|catalog` builds the third-party skill
|
|
22
|
+
catalogue with licence-derived statuses; `aidf skills enable <id>` copies one
|
|
23
|
+
canonical skill into the active adapter directory with an `AIDF-SOURCE.json`
|
|
24
|
+
provenance file; executables and secrets are never copied unless
|
|
25
|
+
`--allow-scripts` is given. Verified by a real copy of `owasp-security`.
|
|
26
|
+
- OpenCode adapter: `aidf install --adapter opencode` writes `AGENTS.md` and
|
|
27
|
+
the 13 built-in skills under `.opencode/skills/`; verification is
|
|
28
|
+
CONTRACT-PROVEN (runtime discovery NOT_PROVEN).
|
|
29
|
+
- Artefact schemas and validation (`src/core/artefacts`, `assets/schemas/`),
|
|
30
|
+
requirements registry and traceability chain (L1-B/L1-C partial).
|
|
31
|
+
- Technology Decision Engine (deterministic analyzer + decision document
|
|
32
|
+
generator; interpretation of trade-offs/risks is delegated to the
|
|
33
|
+
invoking AI agent by design — `analysis.delegation`, no AIDF-owned model).
|
|
34
|
+
- Design Engineering engine (complexity classifier, per-complexity workflows,
|
|
35
|
+
SVG/HTML fallback mockups; Figma integration NOT_PROVEN).
|
|
36
|
+
- Gap matrix: `docs/aidf/MATRICE-0.1.0-vers-0.2.0.md`.
|
|
37
|
+
- CLI commands exposing the L1/L2/L3 engines: `aidf artefacts
|
|
38
|
+
list|show|validate|verify`, `aidf requirements
|
|
39
|
+
list|show|add|update|delete|coverage`, `aidf traceability
|
|
40
|
+
report|verify|missing|broken`, `aidf decision evaluate` (persists a DRAFT
|
|
41
|
+
artefact under `.aidf/artefacts/decisions/`, human approval required) and
|
|
42
|
+
`aidf design classify|run` (writes real SVG/CSS/Markdown fallback outputs).
|
|
43
|
+
- `aidf security analyze|show`: deterministic STRIDE threat model generated
|
|
44
|
+
from project detection (assets, trust boundaries, threats grounded in
|
|
45
|
+
detected surface), persisted as `TM-###` under
|
|
46
|
+
`.aidf/artefacts/security/` with a Markdown report option.
|
|
47
|
+
- `aidf tests plan|coverage`: generates a `TP-###` test-plan artefact (one
|
|
48
|
+
planned case per acceptance criterion, type inferred from wording) and
|
|
49
|
+
reports requirement coverage across planned cases and `TEST-*` artefacts.
|
|
50
|
+
- `aidf docs generate [--check]`: renders canonical artefacts to Markdown
|
|
51
|
+
under `.aidf/docs/generated/` with provenance headers and manual-edit
|
|
52
|
+
divergence detection.
|
|
53
|
+
- `aidf release report [--record] [--strict]`: read-only release readiness
|
|
54
|
+
report aggregating gate evaluations, document statuses, CHANGELOG,
|
|
55
|
+
evidence and artefacts; writes `.aidf/reports/RELEASE-<date>.{json,md}`.
|
|
56
|
+
- Artefact discovery now recurses into subdirectories (`decisions/`,
|
|
57
|
+
`security/`), so nested artefacts appear in `artefacts list`, link
|
|
58
|
+
resolution and traceability; `createLink` writes back to the real path.
|
|
59
|
+
- Migration 0.1.0 → 0.2.0 verified two ways: `tests/migration.test.mjs`
|
|
60
|
+
(legacy fixture upgrades additively, project files preserved, engines
|
|
61
|
+
usable) and a manual run against a real 0.1.0 install copy
|
|
62
|
+
(148 → 198 managed files, 0 conflicts, `doctor` adapter/skills PASS).
|
|
63
|
+
- OpenCode runtime verification (2026-11-21): a real `opencode run` session
|
|
64
|
+
quoted the AIDF instructions and listed the installed skills; `opencode
|
|
65
|
+
debug skill` discovers project skills only inside a git worktree, so
|
|
66
|
+
adapter verification now reports a `git-worktree` check (PARTIAL without
|
|
67
|
+
`.git`).
|
|
68
|
+
|
|
69
|
+
### Removed
|
|
70
|
+
- `src/core/technology-decision/analyzer-llm.mjs` and the `AI_MODEL` /
|
|
71
|
+
`callLLM` path: AIDF is a governance framework and owns no model. The
|
|
72
|
+
decision document now records `analysis.delegation`
|
|
73
|
+
(`delegatedTo: "invoking-agent"`) so interpretation stays with the AI
|
|
74
|
+
agent that runs the command. Deterministic analysis is unchanged and
|
|
75
|
+
remains the only proven path.
|
|
76
|
+
|
|
77
|
+
### Fixed (2026-11-21)
|
|
78
|
+
- `getAllArtefactIds` imported `../util/fsx.mjs` from `core/artefacts/`,
|
|
79
|
+
silently resolving no artefact ids and marking every link unresolved.
|
|
80
|
+
- `findMissingLinks` searched link *values* for type names instead of
|
|
81
|
+
resolving targets; it now matches resolved artefact types plus documented
|
|
82
|
+
ID prefixes (`REQ-`, `DES-`, `BACKEND-`, `TEST-`, `EVID-`).
|
|
83
|
+
- `resources inspect` crashed on files larger than 2 GiB (whole-file
|
|
84
|
+
`readFile`): hashing is now capped at 64 MiB with explicit `skipped`
|
|
85
|
+
counters; secret-like paths are never opened.
|
|
86
|
+
- MODULES corpus exclusions extended to media/binaries (ISO, mp4, archives,
|
|
87
|
+
installers) matching its documented course-document scope.
|
|
88
|
+
- Packaging test: GNU tar on Windows treated `C:\…` tarballs as remote hosts;
|
|
89
|
+
`--force-local` and relative paths fix pack/list/extract/pack-install.
|
|
90
|
+
- Adapter registry test updated for the new `opencode` adapter.
|
|
91
|
+
|
|
92
|
+
Test suite: 211/211 PASS (`node --test "tests/**/*.test.mjs"`).
|
|
93
|
+
|
|
94
|
+
### Fixed
|
|
95
|
+
- npm packaging now ships `INSTALLATION.md`, `UTILISATION.md`, `QODER.md`,
|
|
96
|
+
`CHANGELOG.md` and `demo/`; a packaging test packs, installs, runs
|
|
97
|
+
`--version`, `init` and `doctor` in a temporary prefix.
|
|
98
|
+
- `npm run demo` now runs a real install/doctor/context/gate/resources flow in
|
|
99
|
+
a temporary project; it never prints predefined results.
|
|
100
|
+
- `doc-status` reads the real document frontmatter and fails when it diverges
|
|
101
|
+
from `config.json`; a missing document is `BLOCKED`.
|
|
102
|
+
- A blocking check can no longer be `NOT_APPLICABLE`; a gate with no applicable
|
|
103
|
+
blocking check is `NOT_PROVEN`; a gate with no blocking check must declare
|
|
104
|
+
`applicability: informative` to PASS.
|
|
105
|
+
- `evidence verify` now verifies the whole chain (hashes, `previous` links,
|
|
106
|
+
order, `index.lastHash`, duplicates, missing and unindexed files) and never
|
|
107
|
+
repairs history. `doctor` uses the same verification.
|
|
108
|
+
|
|
109
|
+
### Added
|
|
110
|
+
- Declared vs authenticated approval: `--human --by` records
|
|
111
|
+
`approval.authenticated: false`; `security.requireAuthenticatedApproval`
|
|
112
|
+
(optional, default false) rejects declared-only approval for human-required
|
|
113
|
+
gates. Existing `approvedBy` is preserved.
|
|
114
|
+
- GitHub Actions CI (syntax, test suite, demo, diagnostics); CI execution is
|
|
115
|
+
`NOT_PROVEN` until the repository is under Git.
|
|
116
|
+
- Tests for config, detect, context, resources, docs, evidence, doctor,
|
|
117
|
+
speckit, packaging, and the new gate/approval semantics. 87 tests pass.
|
|
118
|
+
|
|
119
|
+
## [0.1.0] — 2026-10-31
|
|
120
|
+
|
|
121
|
+
### Added
|
|
122
|
+
- Core action engine (`Installer`): `write/copy/mkdir/managed-block/merge-json/
|
|
123
|
+
junction` with manifest ownership, SHA-256 tracking, backups, conflict
|
|
124
|
+
refusal, atomic writes and full dry-run support (`WOULD_*` statuses).
|
|
125
|
+
- Portable install layout: `.aidf/framework` self-contained copy, launcher
|
|
126
|
+
`.aidf/bin/aidf.mjs`, docs/registry/workflows/knowledge/evidence/state, and
|
|
127
|
+
idempotent re-installation.
|
|
128
|
+
- CLI commands with `--json` and the 0/1/2 exit contract: `install`, `init`,
|
|
129
|
+
`update`, `uninstall`, `setup resources`, `resources list|inspect`, `doctor`,
|
|
130
|
+
`scan`, `skills list|validate|show|refresh|link`, `workflow status|enter|exit|
|
|
131
|
+
next|reset`, `validate --list|--phase|--gate`, `evidence list|show|add|
|
|
132
|
+
capture|verify`, `docs list|show|status`, `context --task`, `speckit
|
|
133
|
+
status|init|sync`, `config list|get|set|validate`, `help`, `version`.
|
|
134
|
+
- 11 project document templates with status frontmatter and explicit
|
|
135
|
+
`[TO FILL]` honesty; `aidf docs status` updates frontmatter + manifest.
|
|
136
|
+
- Qoder adapter: 3 rules (00-core, 10-security, 20-context), 13 first-party
|
|
137
|
+
skills, `aidf-orchestrator` agent, optional hooks with redacted audit and
|
|
138
|
+
session context; verifier returning CONTRACT-PROVEN (files) vs NOT_PROVEN
|
|
139
|
+
(runtime UI checks).
|
|
140
|
+
- Generic adapter: AGENTS.md managed block only.
|
|
141
|
+
- Phase workflow (8 phases, 16 gates) with typed checks (`file-exists`,
|
|
142
|
+
`doc-status`, `evidence`, `command`, `previous-gate`, `manual`), command
|
|
143
|
+
execution opt-in (`--allow-exec` or config), shell-free runner rejecting
|
|
144
|
+
shell operators, output captured as evidence.
|
|
145
|
+
- Hash-chained evidence with human approvals (`--by`) and verification tooling.
|
|
146
|
+
- Context assembler with always-on/phase/keyword activation map, caps, and a
|
|
147
|
+
BLOCKED status for contradiction-sensitive documents.
|
|
148
|
+
- Spec Kit integration: status/init/sync; qodercli init; explicit
|
|
149
|
+
`--specify-force` for non-empty projects; copy-with-hash constitution sync
|
|
150
|
+
(CONFLICT never overwrites Spec Kit content); mapping export to
|
|
151
|
+
`.specify/aidf/mapping.md`.
|
|
152
|
+
- Resource registry + lock (`resources.lock.json`) with licence gating:
|
|
153
|
+
unknown licence ⇒ BLOCKED, index-only.
|
|
154
|
+
- 43 tests (unit + CLI end-to-end) passing on Node 24.21.0 / Windows 11 x64.
|
|
155
|
+
|
|
156
|
+
### Fixed
|
|
157
|
+
- YAML dumper emitted invalid sequence-of-maps (first entry glued to the
|
|
158
|
+
second); roundtrip now verified, including nested arrays and block scalars.
|
|
159
|
+
- `specKitStatus` now detects the real `speckit-*` (hyphen) skill dirs
|
|
160
|
+
generated by specify 1.2.3's qodercli integration.
|
|
161
|
+
- `setup resources` resolution order (project → parent → framework parent →
|
|
162
|
+
framework root) stops installed-copy internal paths (`.aidf/skills`)
|
|
163
|
+
from shadowing real sibling clones.
|
|
164
|
+
- Dry-run installs no longer create `.aidf/logs` (no side effects at all).
|
|
165
|
+
- `Installer.apply` returns only the current batch's results (previously
|
|
166
|
+
accumulated, breaking idempotency reporting in tests).
|
|
167
|
+
- `speckit init` against a non-empty (already installed) project reports
|
|
168
|
+
BLOCKED with an actionable message instead of a raw specify failure.
|
|
169
|
+
|
|
170
|
+
### Known limitations
|
|
171
|
+
- Qoder rule activation and runtime skill discovery remain manual/human-evidenced
|
|
172
|
+
(by design, not a bug).
|
|
173
|
+
- Spec Kit project-vs-user skill precedence in Qoder docs is contradictory;
|
|
174
|
+
AIDF ignores driver-specific resolution order (project scope only).
|
package/INSTALLATION.md
ADDED
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
# AIDF — INSTALLATION (mode d'emploi pas-à-pas)
|
|
2
|
+
|
|
3
|
+
Ce guide décrit l'installation **réelle et vérifiée** d'AIDF dans un projet,
|
|
4
|
+
sa mise à jour et sa désinstallation. Prérequis, options, sorties attendues et
|
|
5
|
+
dépannage inclus.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 1. Prérequis
|
|
10
|
+
|
|
11
|
+
| Prérequis | Détail |
|
|
12
|
+
|---|---|
|
|
13
|
+
| Node.js ≥ 20.11 | Validé sur v24.21.0 (Windows 11). `node --version` doit répondre. |
|
|
14
|
+
| aucun paquet npm | AIDF n'a **aucune dépendance runtime** (vérifié : fonctionne sans `npm install`). |
|
|
15
|
+
| Qoder IDE (optionnel) | Pour l'adaptateur `qoder` : règles/skills/agent/hooks dans `.qoder/`. Sans Qoder, utilisez `--adapter generic` (bloc `AGENTS.md` seulement). |
|
|
16
|
+
| `specify` CLI (optionnel) | Pour l'intégration Spec Kit (`aidf speckit …`) — sinon les gates spec-kit passent en `NOT_APPLICABLE`. |
|
|
17
|
+
| git (optionnel) | Pour des diff d'evidence riches ; sans git, AIDF fonctionne (evidence par liste de fichiers). |
|
|
18
|
+
|
|
19
|
+
## 2. Installer AIDF dans un projet
|
|
20
|
+
|
|
21
|
+
### 2.1 Depuis l'intérieur du projet (recommandé)
|
|
22
|
+
|
|
23
|
+
```powershell
|
|
24
|
+
cd C:\chemin\vers\votre-projet
|
|
25
|
+
node C:\chemin\vers\aidf\bin\aidf.mjs install --adapter qoder --with-hooks
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
### 2.2 Depuis l'extérieur (cible explicite)
|
|
29
|
+
|
|
30
|
+
```powershell
|
|
31
|
+
node C:\chemin\vers\aidf\bin\aidf.mjs install --target C:\projets\mon-projet --adapter qoder --with-hooks
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
### 2.3 Sortie attendue (réelle)
|
|
35
|
+
|
|
36
|
+
```
|
|
37
|
+
[INFO] AIDF install — mon-projet (qoder)
|
|
38
|
+
[INFO] created=135 updated=0 unchanged=0 conflicts=0 failed=0 would=0
|
|
39
|
+
[INFO] Next: node .aidf/bin/aidf.mjs doctor
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
### 2.4 Options
|
|
43
|
+
|
|
44
|
+
| Option | Effet |
|
|
45
|
+
|---|---|
|
|
46
|
+
| `--adapter qoder` | Génère règles + 13 skills + agent + (avec hooks) hooks dans `.qoder/` (défaut). |
|
|
47
|
+
| `--adapter generic` | Uniquement le bloc managé `AGENTS.md` (tout IDE compatible AGENTS.md). |
|
|
48
|
+
| `--with-hooks` | Installe aussi `.aidf/hooks/*.mjs` + entrées `SessionStart`/`PostToolUse` dans `.qoder/settings.json` (vos clés/rootSettings conservées). |
|
|
49
|
+
| `--dry-run` | **N'écrit absolument rien** (pas même les logs) ; affiche le plan `WOULD_*`. |
|
|
50
|
+
| `--force` | Ne concerne que les fichiers AIDF déjà présents et modifiés localement (backup automatique dans `.aidf/backups/`). |
|
|
51
|
+
| `--name <nom>` | Nom du projet dans la config. |
|
|
52
|
+
|
|
53
|
+
### 2.5 Ce qui est préservé (invariants, testés)
|
|
54
|
+
|
|
55
|
+
- Un `AGENTS.md` existant : votre contenu est conservé, le bloc AIDF est
|
|
56
|
+
ajouté entre marqueurs `AIDF:BEGIN/END`.
|
|
57
|
+
- Vos propres règles `.qoder/rules/**` : jamais touchées (seules `aidf-*` sont créées).
|
|
58
|
+
- Un `.qoder/settings.json` existant : fusion **additive** (vos hooks restent).
|
|
59
|
+
- `.env`, `.git`, `node_modules` : ignorés ; **le contenu des secrets n'est jamais lu**.
|
|
60
|
+
- Ré-exécuter `install` : `created=0 updated=0 unchanged=N` (idempotent).
|
|
61
|
+
|
|
62
|
+
## 3. Après l'installation : vérifier en 4 commandes
|
|
63
|
+
|
|
64
|
+
```powershell
|
|
65
|
+
node .aidf\bin\aidf.mjs doctor # bilan de santé (attendu : rien de FAIL)
|
|
66
|
+
node .aidf\bin\aidf.mjs scan --record # inventaire + evidence + report SCAN.md
|
|
67
|
+
node .aidf\bin\aidf.mjs skills validate # 13 skills AVAILABLE attendues
|
|
68
|
+
node .aidf\bin\aidf.mjs workflow status # phase courante (intake)
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
Doctor `--json` donne la même chose en machine-lisible. Les 3 checks
|
|
72
|
+
`runtime-*` de l'adaptateur restent `NOT_PROVEN` tant que l'étape Qoder
|
|
73
|
+
ci-dessous n'a pas été faite par un humain — c'est voulu et documenté.
|
|
74
|
+
|
|
75
|
+
> **IMPORTANT — étape Qoder (3 minutes, une fois par projet)** : suivre les
|
|
76
|
+
> étapes 1→5 de `QODER.md` (ouvrir le projet, `/skills`, Always Apply sur
|
|
77
|
+
> `aidf-00-core` et `aidf-10-security`), puis enregistrer la preuve :
|
|
78
|
+
> `aidf evidence add --type qoder-runtime-activation --human --by "votre_nom"`.
|
|
79
|
+
|
|
80
|
+
## 4. Mettre à jour
|
|
81
|
+
|
|
82
|
+
Depuis une copie **plus récente** du framework :
|
|
83
|
+
|
|
84
|
+
```powershell
|
|
85
|
+
node C:\chemin\vers\nouveau-aidf\bin\aidf.mjs update --target C:\projets\mon-projet --adapter qoder --with-hooks
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
- Seuls les fichiers **managés** sont rafraîchis ; vos documents
|
|
89
|
+
(`.aidf/docs/*`), evidence et état workflow sont préservés.
|
|
90
|
+
- Un fichier managé que vous avez édité → `CONFLICT` (exit 2), contenu
|
|
91
|
+
préservé. Résolution : fusionner à la main, ou `update --force` (backup
|
|
92
|
+
automatique créé d'abord).
|
|
93
|
+
- Idempotence vérifiée : `created=0 updated=14 unchanged=121 conflicts=0`.
|
|
94
|
+
|
|
95
|
+
## 5. Désinstaller
|
|
96
|
+
|
|
97
|
+
```powershell
|
|
98
|
+
node .aidf\bin\aidf.mjs uninstall --dry-run # aperçu (rien n'écrit)
|
|
99
|
+
node .aidf\bin\aidf.mjs uninstall --yes # retire tout ce qu'AIDF possède
|
|
100
|
+
node .aidf\bin\aidf.mjs uninstall --yes --keep-data # garde .aidf/docs + evidence
|
|
101
|
+
node .aidf\bin\aidf.mjs uninstall --yes --force # inclut aussi les fichiers managés édités (backup)
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
Vérifié en réel : sans `--yes` → **refus (exit 1)** ; `AGENTS.md` restauré
|
|
105
|
+
(bloc retiré ; fichier supprimé uniquement s'il ne contenait que le bloc) ;
|
|
106
|
+
vos `existing.md` dans `.qoder/rules/` restent ; les entrées de hooks AIDF
|
|
107
|
+
sont retirées de `.qoder/settings.json` sans toucher au reste ; `.env` intact.
|
|
108
|
+
|
|
109
|
+
## 6. CI / usage non-interactif
|
|
110
|
+
|
|
111
|
+
Toute commande accepte `--json` et suit le contrat 0/1/2. Exemple :
|
|
112
|
+
|
|
113
|
+
```powershell
|
|
114
|
+
node .aidf\bin\aidf.mjs doctor --json
|
|
115
|
+
node .aidf\bin\aidf.mjs validate --phase testing --kind exit --allow-exec --json
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
Pour exécuter des commandes déclarées (tests, build, audit) depuis les gates,
|
|
119
|
+
autorisez une fois dans la config : `aidf config set
|
|
120
|
+
security.allowCommandExecution true` — ou utilisez `--allow-exec` ponctuel.
|
|
121
|
+
C'est shell-free, opérateurs refusés, sortie tronquée et enregistrée.
|
|
122
|
+
|
|
123
|
+
## 7. Un install par projet
|
|
124
|
+
|
|
125
|
+
AIDF se résout **un root par projet** (marqueur `.aidf/manifest.json`).
|
|
126
|
+
Workspaces multi-projets : installez AIDF dans chaque projet ; le workspace
|
|
127
|
+
lui-même peut être gouverné comme n'importe quel projet (c'est le cas de ce
|
|
128
|
+
dépôt).
|
|
129
|
+
|
|
130
|
+
## 8. Dépannage installation
|
|
131
|
+
|
|
132
|
+
| Symptôme | Cause | Remède |
|
|
133
|
+
|---|---|---|
|
|
134
|
+
| `AIDF is not initialized …` | Lancement hors projet installé | Lancez dans le projet ou ajoutez `--target <chemin>`. |
|
|
135
|
+
| `… conflicts=1`, exit 2 | Fichier managé édité localement | Fusion manuelle, ou `install/update --force` (backup auto). |
|
|
136
|
+
| Doctor `runtime-* NOT_PROVEN` | Étape UI Qoder non faite | Suivre `QODER.md` puis enregistrer l'evidence humaine. |
|
|
137
|
+
| Doctor `spec-kit NOT_APPLICABLE` | Pas de `.specify/` | Optionnel : `aidf speckit init` (+ `--specify-force` si projet non vide). |
|
|
138
|
+
| Les gates « command » disent BLOCKED | Exécution non autorisée | `--allow-exec` une fois, ou `config set security.allowCommandExecution true`. |
|
|
139
|
+
| `specify init` échoue « not empty » | Projet déjà peuplé (normal) | `aidf speckit init --specify-force` (opt-in explicite, merge vérifié non-destructif). |
|
|
140
|
+
| `skills validate` signale `INCOMPATIBLE` | Frontmatter non conforme (nom >64 / description >1024) | Corriger la SKILL.md source, puis `skills refresh`. |
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 AIDF contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/QODER.md
ADDED
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
# AIDF — QODER (guide d'intégration de l'IDE)
|
|
2
|
+
|
|
3
|
+
Qoder est le premier adaptateur supporté (`--adapter qoder`). Ce guide
|
|
4
|
+
explique ce qui est installé, **ce qu'un humain doit faire une fois dans
|
|
5
|
+
l'IDE**, et les limites honnêtes.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 1. Ce qu'AIDF installe pour Qoder (vérifié au fichier près)
|
|
10
|
+
|
|
11
|
+
| Emplacement | Contenu |
|
|
12
|
+
|---|---|
|
|
13
|
+
| `AGENTS.md` | Bloc managé `AIDF:BEGIN/END` pointant vers `.aidf/AIDF.md` (contenu utilisateur préservé, restauration à l'uninstall) |
|
|
14
|
+
| `.qoder/rules/aidf-00-core.md` | Règle socle : inspecter avant modifier, statuts, evidence |
|
|
15
|
+
| `.qoder/rules/aidf-10-security.md` | Règle sécurité : secrets jamais lus, exécution opt-in, fichiers protégés |
|
|
16
|
+
| `.qoder/rules/aidf-20-context.md` | Règle contexte : lire `.aidf/state/context/latest.md` avant d'agir |
|
|
17
|
+
| `.qoder/skills/aidf-*/SKILL.md` | 13 skills premières (nom ≤ 64, description ≤ 1024 : contraintes Qoder respectées et testées) |
|
|
18
|
+
| `.qoder/agents/aidf-orchestrator.md` | Agent orchestrateur (outils Read/Grep/Glob/Bash + liste des skills) |
|
|
19
|
+
| `.qoder/settings.json` (option `--with-hooks`) | Entrées `SessionStart` (contexte de session) et `PostToolUse` (audit) **fusionnées** — VOS settings existants sont conservés |
|
|
20
|
+
| `.aidf/hooks/session-context.mjs`, `audit.mjs` | Hooks : rappel de phase / docs bloquées ; audit **métadonnées seulement** (jamais le contenu des fichiers) |
|
|
21
|
+
|
|
22
|
+
Coexistence : les `speckit-*` générés par Spec Kit et vos propres `*.md` de
|
|
23
|
+
règles coexistent sans collision (les fichiers AIDF portent tous le préfixe `aidf-`).
|
|
24
|
+
|
|
25
|
+
## 2. Activation runtime — 3 étapes HUMAINES (5 minutes, une fois par projet)
|
|
26
|
+
|
|
27
|
+
Ce que le système de fichiers ne peut PAS prouver : que Qoder **charge** les
|
|
28
|
+
règles, découverte les skills et exécute les hooks. D'où le statut
|
|
29
|
+
`NOT_PROVEN` assumé dans `doctor`. Voici la procédure exacte :
|
|
30
|
+
|
|
31
|
+
### Étape 1 — Découverte des skills
|
|
32
|
+
1. Ouvrir le projet dans Qoder et attendre la fin de l'indexation.
|
|
33
|
+
2. Ouvrir la palette/chat et exécuter la commande **`/skills`**.
|
|
34
|
+
3. Verifier la présence des 13 `aidf-*` (et, si installé, des 10 `speckit-*`).
|
|
35
|
+
|
|
36
|
+
### Étape 2 — Activation des règles
|
|
37
|
+
1. Ouvrir **Settings → Rules** dans Qoder.
|
|
38
|
+
2. Mettre `aidf-00-core` et `aidf-10-security` en **Always Apply**.
|
|
39
|
+
3. Laisser `aidf-20-context` en `Model Decision` (ou `Specific Files`).
|
|
40
|
+
4. Le type d'activation est un **réglage UI** de Qoder : il n'est pas encodé
|
|
41
|
+
dans le fichier `.md` (c'est pourquoi le filesystem ne peut pas le prouver).
|
|
42
|
+
|
|
43
|
+
### Étape 3 — Test des hooks (si `--with-hooks`)
|
|
44
|
+
1. Redémarrer Qoder (chargement du `SessionStart`).
|
|
45
|
+
2. Faire une modification minuscule dans un fichier du projet.
|
|
46
|
+
3. Vérifier qu'une ligne d'audit apparaît dans `.aidf/logs/audit-<date>.jsonl`.
|
|
47
|
+
|
|
48
|
+
### Enregistrer la preuve (transforme NOT_PROVEN en PROVEN nominatif)
|
|
49
|
+
|
|
50
|
+
```powershell
|
|
51
|
+
aidf evidence add --type qoder-runtime-activation --human --by "votre_nom" --note "/skills: 13 aidf-*; Always Apply: core + security; audit JSONL reçu"
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Après cette evidence, `doctor` reflète l'activation prouvée par un humain
|
|
55
|
+
identifié. Sans cette evidence, aucune commande AIDF ne la simulera — par
|
|
56
|
+
conception.
|
|
57
|
+
|
|
58
|
+
## 3. Ce que les règles font concrètement pour vous
|
|
59
|
+
|
|
60
|
+
Quand l'IA codeuse travaille dans Qoder :
|
|
61
|
+
|
|
62
|
+
1. Elle **lit le contexte** (`.aidf/state/context/latest.md`) au démarrage de
|
|
63
|
+
la session (le hook SessionStart y contribue).
|
|
64
|
+
2. Elle **ne touche pas** : vos fichiers hors manifest, vos secrets, le bloc
|
|
65
|
+
`AIDF:BEGIN/END` de `AGENTS.md`.
|
|
66
|
+
3. Elle **enregistre** : toute affirmation de test/release passe par les
|
|
67
|
+
gates et l'evidence nominative.
|
|
68
|
+
4. Elle **sait quoi lire** : les mots-clés de la tâche déclenchent le bon
|
|
69
|
+
ensemble docs/skills (ex. « rgpd/cnil » → SECURITY + security-review).
|
|
70
|
+
|
|
71
|
+
## 4. Limites documentées (honnêtes)
|
|
72
|
+
|
|
73
|
+
| Limite | Détail | Position AIDF |
|
|
74
|
+
|---|---|---|
|
|
75
|
+
| Type d'activation des règles | Réglage UI, non encodé dans le fichier | Rappel écrit dans la règle ; preuve humaine exigée |
|
|
76
|
+
| Precedence skills projet vs utilisateur | La doc Qoder se contredit (IDE vs CLI) | AIDF installe au niveau **projet** uniquement et ne dépend pas de cet ordre |
|
|
77
|
+
| `.qoder/commands` | Legacy (abandonné par Qoder 1.24+) | Non généré ; les skills sont le mécanisme actuel (vérifié avec Spec Kit qodercli) |
|
|
78
|
+
| Hooks sous environnement Qoder | S'exécutent dans le process de l'IDE | `audit.mjs` ne logue que chemins relatifs + nom d'outil (jamais de contenu) → secret-safe par construction |
|
|
79
|
+
| Runtime Qoder non installé (`qodercli` absent du PATH) | Doctor le signale | L'activation reste une étape humaine dans l'IDE, non automatisable honnêtement |
|
|
80
|
+
|
|
81
|
+
## 5. Dépannage Qoder
|
|
82
|
+
|
|
83
|
+
| Symptôme | Cause probable | Remède |
|
|
84
|
+
|---|---|---|
|
|
85
|
+
| `/skills` ne montre pas les `aidf-*` | Projet non réindexé / skills hors projet | Réouvrir le projet ; vérifier `.qoder/skills/aidf-*/SKILL.md` présents ; relancer `aidf doctor`. |
|
|
86
|
+
| Les règles « ne s'appliquent pas » | Toujours `Model Decision` | les passer en **Always Apply** (étape 2) puis enregistrer l'evidence. |
|
|
87
|
+
| Pas de fichier `audit-*.jsonl` | Hooks non chargés / install sans `--with-hooks` | Réinstaller avec `--with-hooks`, redémarrer Qoder. |
|
|
88
|
+
| Conflit de hook dans `settings.json` | Édition manuelle hasardeuse | Le merge AIDF est additif ; comparer avec `.aidf/backups/<ts>/` si besoin. |
|
package/README.md
CHANGED
|
@@ -1,3 +1,143 @@
|
|
|
1
|
-
#
|
|
1
|
+
# AIDF — AI Development Framework
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**Version 0.2.0** · MIT · Node.js ≥ 20.11 · zéro dépendance runtime
|
|
4
|
+
|
|
5
|
+
> AIDF est une **couche de gouvernance installable** dans un projet : elle
|
|
6
|
+
> encadre le développement assisté par IA (agents, Qoder, Spec Kit) avec des
|
|
7
|
+
> preuves mesurables — pas des promesses.
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## À quoi ça sert (le problème qu'AIDF résout)
|
|
12
|
+
|
|
13
|
+
Un assistant IA qui code est puissant, mais présente 4 risques réels :
|
|
14
|
+
|
|
15
|
+
| Risque | Sans AIDF | Avec AIDF |
|
|
16
|
+
|---|---|---|
|
|
17
|
+
| **Le faux succès** | « Les tests passent » alors que rien n'a tourné | Un test ne compte que s'il a **réellement** été exécuté et enregistré comme evidence hashée |
|
|
18
|
+
| **L'écrasement silencieux** | L'agent réécrit vos fichiers | Tout fichier écrit est **dans un manifest** (SHA-256) ; vos fichiers ne sont jamais touchés ; toute écriture sur du managé modifié → `CONFLICT`, votre contenu préservé |
|
|
19
|
+
| **Les secrets** | L'agent lit/affiche `.env`, clés… | Politique : **jamais lu, jamais affiché** (noms listés seulement) — vérifié par tests |
|
|
20
|
+
| **La dispersion des règles** | Règles éparpillées, jamais appliquées | Des règles/skills **installées dans l'IDE** (Qoder) + un **sélecteur de contexte** qui choisit quoi lire par tâche |
|
|
21
|
+
|
|
22
|
+
**Utilité en une phrase** : chaque phase (intake → … → release) a des **gates
|
|
23
|
+
exécutable** ; rien ne passe sans preuve enregistrée ; les approbations
|
|
24
|
+
humaines sont nominatives (`--by "prénom"`).
|
|
25
|
+
|
|
26
|
+
## Ce qu'AIDF fait / ne fait pas
|
|
27
|
+
|
|
28
|
+
**Fait** : installer ~190 fichiers gouvernés dans un projet ; 26 commandes CLI
|
|
29
|
+
(`--json`, exit 0/1/2) dont les moteurs L1–L3 — artefacts canoniques
|
|
30
|
+
(JSON + validation), registre d'exigences, traçabilité exigence→design→
|
|
31
|
+
implémentation→test→preuve, Decision Engine déterministe (interprétation
|
|
32
|
+
déléguée à l'agent hôte), Design Engine (classifieur + mockups SVG/CSS de
|
|
33
|
+
secours), inventaire complet des ressources externes (sha256, licences,
|
|
34
|
+
secrets exclus), catalogue et activation explicite des skills tierces,
|
|
35
|
+
modèle de menace STRIDE, plan de test par critère d'acceptation, génération
|
|
36
|
+
de documentation Markdown avec détection de divergence, et rapport de
|
|
37
|
+
release consolidé ; gérer 8 phases / 16 gates ; chaîner l'evidence
|
|
38
|
+
(SHA-256) ; 13 skills built-in + adaptateurs **Qoder**, **OpenCode**
|
|
39
|
+
(runtime prouvé) et **generic** (AGENTS.md + `.aidf/skills/`) ; intégrer
|
|
40
|
+
GitHub Spec Kit **sans duplication** ; enregistrer des ressources externes
|
|
41
|
+
avec gating de licences.
|
|
42
|
+
|
|
43
|
+
**Ne fait pas** : choisir l'architecture de votre projet ; exécuter des
|
|
44
|
+
commandes sans permission (`--allow-exec` ou config) ; toucher au réseau sans
|
|
45
|
+
autorisation ; lire vos secrets ; se substituer à l'IDE ; publier/pusher.
|
|
46
|
+
|
|
47
|
+
## Démarrage rapide (3 commandes), résultat réel
|
|
48
|
+
|
|
49
|
+
```powershell
|
|
50
|
+
# via npm (package framework-aidf) ou depuis un clone/portable
|
|
51
|
+
npx framework-aidf install --target C:\projets\mon-projet --adapter qoder --with-hooks
|
|
52
|
+
# → [INFO] created=~190 updated=0 unchanged=0 conflicts=0 failed=0
|
|
53
|
+
|
|
54
|
+
cd C:\projets\mon-projet
|
|
55
|
+
node .aidf\bin\aidf.mjs doctor # → tout PASS sauf runtime Qoder (NOT_PROVEN, voir QODER.md)
|
|
56
|
+
node .aidf\bin\aidf.mjs context --task "ma première tâche"
|
|
57
|
+
node .aidf\bin\aidf.mjs release report # → bilan de release READY/NOT_READY
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Le **premier workflow complet documenté pas-à-pas** (projet TaskFlow, du
|
|
61
|
+
« dicté humain » à la release) est dans `UTILISATION.md` §Exemple réel.
|
|
62
|
+
|
|
63
|
+
## Les commandes (26 verbes)
|
|
64
|
+
|
|
65
|
+
| Commande | Rôle |
|
|
66
|
+
|---|---|
|
|
67
|
+
| `install` / `init` | Installer la gouvernance dans un projet (identique, idempotent) |
|
|
68
|
+
| `update` | Rafraîchir les fichiers managés (backups auto ; `--force` en cas d'édition locale) |
|
|
69
|
+
| `uninstall` | Retirer AIDF (`--yes` requis ; `--keep-data` garde docs+evidence) |
|
|
70
|
+
| `doctor` | Bilan de santé complet (contrats, manifest, evidence, sécurité) |
|
|
71
|
+
| `scan` | Inventaire du projet (`--record` → report + evidence ; secrets en noms seulement) |
|
|
72
|
+
| `context --task` | Choisir les documents/skills à lire pour une tâche ; `BLOCKED` si contradiction |
|
|
73
|
+
| `workflow status/enter/exit/next` | Avancer **par gates**, jamais en sautant |
|
|
74
|
+
| `validate --gate / --phase` | Évaluer une gate (avec `--allow-exec` pour les commandes) |
|
|
75
|
+
| `evidence add/capture/verify` | Enregistrer/vérifier les preuves (chaîne SHA-256, `--human --by`) |
|
|
76
|
+
| `docs list/show/status/generate` | Les 11 documents projet + statuts ; `generate` rend les artefacts en Markdown (`--check` détecte les éditions manuelles) |
|
|
77
|
+
| `skills list/validate/show/link/refresh/sources/catalog/enable` | Catalogue builtin + skills tierces (licences, doublons, provenance `AIDF-SOURCE.json`) |
|
|
78
|
+
| `config get/set` | Configuration (`commands.*`, `security.*`) |
|
|
79
|
+
| `resources inventory/coverage/reconcile/inspect` | Inventaire sha256 des ressources, politique de licences, dérive lock/manifest |
|
|
80
|
+
| `speckit status/init/sync` | Intégration GitHub Spec Kit (mapping, constitution) |
|
|
81
|
+
| `artefacts list/show/validate/verify` | Artefacts canoniques (exigences, designs, décisions, tests, threat model) |
|
|
82
|
+
| `requirements add/list/show/update/delete/coverage` | Registre d'exigences `REQ-F/NF-###` + couverture |
|
|
83
|
+
| `traceability report/verify/missing/broken` | Chaîne de traçabilité et liens cassés/manquants |
|
|
84
|
+
| `decision evaluate` | Decision Engine déterministe → artefact `decisions/` DRAFT (approbation humaine requise) |
|
|
85
|
+
| `design classify/run` | Classifieur de complexité + workflows de design (mockups SVG/CSS de secours) |
|
|
86
|
+
| `security analyze/show` | Modèle de menace STRIDE `TM-###` généré depuis la détection projet |
|
|
87
|
+
| `tests plan/coverage` | Plan de test `TP-###` (1 cas par critère) + couverture exigence→test |
|
|
88
|
+
| `release report` | Rapport de release READY/NOT_READY (`--record`, `--strict`, `--allow-exec`) |
|
|
89
|
+
| `help`, `version` | Aide et version |
|
|
90
|
+
|
|
91
|
+
Contrat de codes de sortie : **0** succès · **1** échec/refus · **2** conflit/contradiction.
|
|
92
|
+
|
|
93
|
+
## Vocabulaire de statuts (honnêteté intégrée)
|
|
94
|
+
|
|
95
|
+
- **Documents** : `DRAFT`, `VALIDATED` (exige `--by`), `BLOCKED`, `OUTDATED`, `NOT_APPLICABLE` (exige `--note`).
|
|
96
|
+
- **Gates** : `PASS`, `BLOCKED`, `FAIL`, `NOT_PROVEN`, `NOT_APPLICABLE` — un `NOT_PROVEN` est un état fiable, pas une défaillance.
|
|
97
|
+
- **Skills** : `DISCOVERED` → `VALIDATED` → `REGISTERED` → `AVAILABLE` (`BLOCKED`, `INCOMPATIBLE`).
|
|
98
|
+
- **Rapports** : `PROVEN` (mesuré) · `CONTRACT-PROVEN` (fichiers/contrats) · `NOT_PROVEN` (demande une action humaine) · `BLOCKED` · `NOT_APPLICABLE`.
|
|
99
|
+
|
|
100
|
+
## Ce qui est installé dans votre projet
|
|
101
|
+
|
|
102
|
+
```
|
|
103
|
+
AGENTS.md bloc managé (votre contenu préservé)
|
|
104
|
+
.qoder/ règles + 13 skills + agent + hooks (adaptateur qoder)
|
|
105
|
+
.opencode/skills/ 13 skills (adaptateur opencode — runtime prouvé)
|
|
106
|
+
.aidf/skills/ 13 skills (adaptateur generic — tout hôte AGENTS.md)
|
|
107
|
+
.aidf/AIDF.md point d'entrée agent
|
|
108
|
+
.aidf/bin/aidf.mjs lanceur portable
|
|
109
|
+
.aidf/framework/ copie autonome du framework
|
|
110
|
+
.aidf/docs/ 11 documents avec statuts + docs/generated/
|
|
111
|
+
.aidf/artefacts/ exigences, décisions, test-plan, threat-model
|
|
112
|
+
.aidf/registry/ skills, activation-map, dependencies, resources.lock.json
|
|
113
|
+
.aidf/workflows/ phases.yaml + gates.yaml (modifiables projet)
|
|
114
|
+
.aidf/evidence/ preuves chaînées + index
|
|
115
|
+
.aidf/state/, reports/, backups/, logs/
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
## Documentation
|
|
119
|
+
|
|
120
|
+
**Guides pratique (français)** : `INSTALLATION.md` · `UTILISATION.md` · `QODER.md`
|
|
121
|
+
|
|
122
|
+
**Références techniques (anglais)**, dans `docs/aidf/` : `ARCHITECTURE.md`,
|
|
123
|
+
`DECISIONS.md` (DEC-001…014), `SKILLS.md`, `SPECKIT.md`, `SECURITY.md`,
|
|
124
|
+
`VALIDATION.md` (les mesures), `LIMITATIONS.md`, `COMPATIBILITY.md`,
|
|
125
|
+
`INVENTORY.md`, `FRAMEWORK.md`.
|
|
126
|
+
|
|
127
|
+
**Journal** : `CHANGELOG.md` (v0.2.0 : moteurs artefacts/requirements/traceability/décision/design, inventaire ressources, skills tierces, adaptateur OpenCode, threat model, test plan, docs generate, release report, migration 0.1.0→0.2.0 prouvée).
|
|
128
|
+
|
|
129
|
+
## Preuves de qualité (mesurées, pas déclarées)
|
|
130
|
+
|
|
131
|
+
- **212/212 tests** `node --test` (incluant un E2E du CLI : install → doctor →
|
|
132
|
+
scan → skills → context → gate → config → speckit → uninstall).
|
|
133
|
+
- **E2E en situation réelle** : projet TaskFlow gouverné de bout en bout,
|
|
134
|
+
2 bugs réels détectés/corrigés par les gates, conflit d'édition humain
|
|
135
|
+
traité en exit 2 + backup, Spec Kit installé en merge, 23 evidence
|
|
136
|
+
chaînées vérifiées.
|
|
137
|
+
- Validation détaillée : `docs/aidf/VALIDATION.md`.
|
|
138
|
+
|
|
139
|
+
## Licence
|
|
140
|
+
|
|
141
|
+
MIT (`LICENSE`). Le corpus de cours privé `MODULES/` de l'auteur **n'est pas
|
|
142
|
+
distribué** (registry index-only, exclusions strictes : `STAGE/**`, `.env*`,
|
|
143
|
+
`*.pem`, `*.crt`, `*.key`, secrets et arborescences de TP).
|