- Move ASPICE docs to chanoraapp/docs submodule at docs/ - Move development docs to dev-docs/ (superpowers, offline-knowledge, impl-mapping) - Add AGENTS.md with project conventions for AI agents - Add impl-mapping.md (SAD component → source file mapping) - Archive completed plans to dev-docs/superpowers/plans/_archived/ - Remove AGENTS.md from .gitignore (now tracked)
115 lines
5.7 KiB
Markdown
115 lines
5.7 KiB
Markdown
# DV Evidence Pack Implementation Plan
|
|
|
|
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
|
|
|
**Goal:** Create a document set that lets a DV meeting review Chanora's current verification posture, traceability, release blockers, waivers, and evidence without implying incomplete work is complete.
|
|
|
|
**Architecture:** The pack is documentation-only. Verification plans live under `docs/verification/`; release decision evidence lives under `docs/release/`; cross-document traceability lives under `docs/governance/`; security, privacy, and legal gate summaries live in their existing README-advertised folders.
|
|
|
|
**Tech Stack:** Markdown, existing SysRS/SysDes/SRS baselines, implementation status report, CI workflow definitions.
|
|
|
|
---
|
|
|
|
### Task 1: Create Verification Plan Set
|
|
|
|
**Files:**
|
|
- Create: `docs/verification/verification-master-plan.md`
|
|
- Create: `docs/verification/swe4-unit-verification-plan.md`
|
|
- Create: `docs/verification/swe5-software-integration-verification-plan.md`
|
|
- Create: `docs/verification/swe6-software-verification-plan.md`
|
|
- Create: `docs/verification/sys4-system-integration-verification-plan.md`
|
|
|
|
- [x] **Step 1: Write master plan**
|
|
|
|
Create `docs/verification/verification-master-plan.md` with lifecycle scope, evidence rules, entry/exit criteria, current evidence sources, open gates, and reviewer decision framing.
|
|
|
|
- [x] **Step 2: Write SWE.4 plan**
|
|
|
|
Create `docs/verification/swe4-unit-verification-plan.md` with unit verification scope for Rust crates, Flutter services/widgets, diagnostics, storage, state reducers, audio DSP, and known unit-test gaps.
|
|
|
|
- [x] **Step 3: Write SWE.5 plan**
|
|
|
|
Create `docs/verification/swe5-software-integration-verification-plan.md` with cross-component integration scope for Flutter-bridge-core, protocol-state, audio-platform, secure storage, diagnostics export, resolver prefetch, and packaging hooks.
|
|
|
|
- [x] **Step 4: Write SWE.6 plan**
|
|
|
|
Create `docs/verification/swe6-software-verification-plan.md` with SRS-level acceptance scope and the SysRS-241 through SysRS-257 MVP acceptance matrix.
|
|
|
|
- [x] **Step 5: Write SYS.4 plan**
|
|
|
|
Create `docs/verification/sys4-system-integration-verification-plan.md` with system-level integration scope for external compatible servers, OS services, hardware, network, app stores, diagnostics, and release evidence.
|
|
|
|
### Task 2: Create Release and DV Decision Records
|
|
|
|
**Files:**
|
|
- Create: `docs/release/release-readiness-go-nogo-record.md`
|
|
- Create: `docs/release/dv-waiver-register.md`
|
|
|
|
- [x] **Step 1: Write release readiness record**
|
|
|
|
Create `docs/release/release-readiness-go-nogo-record.md` with current candidate metadata, decision state, platform readiness, verification status, legal/security/privacy gates, blockers, and meeting recommendation.
|
|
|
|
- [x] **Step 2: Write waiver register**
|
|
|
|
Create `docs/release/dv-waiver-register.md` with explicit waivers for DEC-012, Android Keystore DEK, iOS voice-processing mode, source-build-only desktop/iOS artifacts, state reducer coverage, and VAD deferral.
|
|
|
|
### Task 3: Create Traceability and Gate Summaries
|
|
|
|
**Files:**
|
|
- Create: `docs/governance/traceability-matrix.md`
|
|
- Create: `docs/security/security-privacy-legal-guideline.md`
|
|
- Create: `docs/security/dependency-and-supply-chain-report.md`
|
|
- Create: `docs/privacy/privacy-policy.md`
|
|
- Create: `docs/legal/trademark-and-attribution-review.md`
|
|
|
|
- [x] **Step 1: Write traceability matrix**
|
|
|
|
Create `docs/governance/traceability-matrix.md` summarizing SysRS to SysDes to SRS to verification coverage, including the MVP acceptance and verification handoff items.
|
|
|
|
- [x] **Step 2: Write security/privacy/legal guideline**
|
|
|
|
Create `docs/security/security-privacy-legal-guideline.md` summarizing release gates and evidence expectations for secure storage, diagnostics redaction, dependency review, privacy policy, and affiliation wording.
|
|
|
|
- [x] **Step 3: Write dependency report**
|
|
|
|
Create `docs/security/dependency-and-supply-chain-report.md` summarizing current CI checks and open evidence gaps without claiming DEC-012 completion.
|
|
|
|
- [x] **Step 4: Write privacy policy baseline**
|
|
|
|
Create `docs/privacy/privacy-policy.md` as an engineering release-candidate privacy baseline covering local storage, permissions, diagnostics, and the no automatic telemetry posture.
|
|
|
|
- [x] **Step 5: Write trademark review**
|
|
|
|
Create `docs/legal/trademark-and-attribution-review.md` with current non-affiliation wording requirement and open legal sign-off state.
|
|
|
|
### Task 4: Verify Documentation Pack
|
|
|
|
**Files:**
|
|
- Inspect all created files.
|
|
|
|
- [x] **Step 1: Search for forbidden sentinel text**
|
|
|
|
Run the sentinel-language scan over `docs/verification`, `docs/release`, `docs/governance`, `docs/security`, `docs/privacy`, and `docs/legal`.
|
|
|
|
Expected: no matches introduced by the DV evidence pack except intentional historical references in source documents outside these folders.
|
|
|
|
- [x] **Step 2: Confirm expected files exist**
|
|
|
|
Run: `ls docs/verification docs/release docs/governance docs/security docs/privacy docs/legal`
|
|
|
|
Expected: all DV evidence pack files are listed.
|
|
|
|
- [x] **Step 3: Inspect git status and diff**
|
|
|
|
Run: `git diff -- docs/verification docs/release docs/governance docs/security docs/privacy docs/legal docs/superpowers/plans/2026-05-29-dv-evidence-pack.md`
|
|
|
|
Expected: only intended Markdown additions are present.
|
|
|
|
---
|
|
|
|
## Self-Review
|
|
|
|
- Spec coverage: covers verification plan set, release decision evidence, waiver register, traceability matrix, and minimum security/privacy/legal gate summaries.
|
|
- Placeholder scan: plan contains no incomplete instructions.
|
|
- Type consistency: document paths match the README-advertised folders and task file list.
|