Skip to content

docs(task-9): README rewrite, CLAUDE.md, task_009 completion #27

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ImmortalDemonGod merged 9 commits into from
Mar 28, 2026
Merged

docs(task-9): README rewrite, CLAUDE.md, task_009 completion #27

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
6e096b8
docs(readme): Rewrite for accuracy, clarity, and completeness (Task 9.2)
ImmortalDemonGod Mar 28, 2026
d25cfda
docs(taskmaster): Mark task_009 and all subtasks done
ImmortalDemonGod Mar 28, 2026
0ffef18
docs(claude): Add CLAUDE.md with AIV workflow, gotchas, and project c…
ImmortalDemonGod Mar 28, 2026
744720f
docs(aiv): verification packet for change 'task-9-readme-quality'
ImmortalDemonGod Mar 28, 2026
7e2cf5d
docs(aiv): fix packet — add Class E, fill classification rationale
ImmortalDemonGod Mar 28, 2026
1ea3f4f
docs(readme): Remove migration guide and status table
ImmortalDemonGod Mar 28, 2026
4e96dae
docs(aiv): verification packet for change 'task-9-readme-cleanup'
ImmortalDemonGod Mar 28, 2026
5ea2ea0
docs(aiv): fix packet — add Class E, fill classification_rationale
ImmortalDemonGod Mar 28, 2026
2f919ce
docs(aiv): fix packet — correct risk_tier R1→R0 to match rationale
ImmortalDemonGod Mar 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 14 additions & 16 deletions .github/aiv-evidence/EVIDENCE_.TASKMASTER_TASKS_TASK_009.MD.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
# AIV Evidence File (v1.0)

**File:** `.taskmaster/tasks/task_009.md`
**Commit:** `c638af2`
**Generated:** 2026-03-22T03:30:49Z
**Commit:** `6e096b8`
**Previous:** `92d937e`
**Generated:** 2026-03-28T02:15:06Z
**Protocol:** AIV v2.0 + Addendum 2.7 (Zero-Touch Mandate)

---
Expand All @@ -15,16 +16,15 @@ classification:
sod_mode: S0
critical_surfaces: []
blast_radius: ".taskmaster/tasks/task_009.md"
classification_rationale: "Pure deletion of read-only legacy scaffolding with task-status bookkeeping; no executable logic"
classification_rationale: "Status bookkeeping only; no executable code"
classified_by: "Miguel Ingram"
classified_at: "2026-03-22T03:30:49Z"
classified_at: "2026-03-28T02:15:06Z"
```

## Claim(s)

1. HPE_ARCHIVE/ (57 files) deleted; no flashcore/ or tests/ source imports from it
2. task_009.md subtasks 9.1 and 9.2 marked done
3. No existing tests were modified or deleted during this change.
1. task_009.md status updated to done; subtasks 9.1, 9.2, 9.3 all marked done
2. No existing tests were modified or deleted during this change.

---

Expand All @@ -33,33 +33,31 @@ classification:
### Class E (Intent Alignment)

- **Link:** [https://github.com/ImmortalDemonGod/flashcore/blob/bd7cdab/.taskmaster/tasks/task_009.md](https://github.com/ImmortalDemonGod/flashcore/blob/bd7cdab/.taskmaster/tasks/task_009.md)
- **Requirements Verified:** Task 9.1: Remove HPE_ARCHIVE before final merge to eliminate dual source-of-truth confusion
- **Requirements Verified:** Task 9 completion tracking — all subtasks verified complete

### Class B (Referential Evidence)

**Scope Inventory** (SHA: [`c638af2`](https://github.com/ImmortalDemonGod/flashcore/tree/c638af2b0e1493d84ed6ca76489487485431ef56))
**Scope Inventory** (SHA: [`6e096b8`](https://github.com/ImmortalDemonGod/flashcore/tree/6e096b87fcf9eefeed2f7b9f0ae6800842c8faff))

- [`.taskmaster/tasks/task_009.md#L5`](https://github.com/ImmortalDemonGod/flashcore/blob/c638af2b0e1493d84ed6ca76489487485431ef56/.taskmaster/tasks/task_009.md#L5)
- [`.taskmaster/tasks/task_009.md#L25-L26`](https://github.com/ImmortalDemonGod/flashcore/blob/c638af2b0e1493d84ed6ca76489487485431ef56/.taskmaster/tasks/task_009.md#L25-L26)
- [`.taskmaster/tasks/task_009.md#L36-L37`](https://github.com/ImmortalDemonGod/flashcore/blob/c638af2b0e1493d84ed6ca76489487485431ef56/.taskmaster/tasks/task_009.md#L36-L37)
- [`.taskmaster/tasks/task_009.md#L47`](https://github.com/ImmortalDemonGod/flashcore/blob/c638af2b0e1493d84ed6ca76489487485431ef56/.taskmaster/tasks/task_009.md#L47)
- [`.taskmaster/tasks/task_009.md#L5`](https://github.com/ImmortalDemonGod/flashcore/blob/6e096b87fcf9eefeed2f7b9f0ae6800842c8faff/.taskmaster/tasks/task_009.md#L5)
- [`.taskmaster/tasks/task_009.md#L47`](https://github.com/ImmortalDemonGod/flashcore/blob/6e096b87fcf9eefeed2f7b9f0ae6800842c8faff/.taskmaster/tasks/task_009.md#L47)

### Class A (Execution Evidence)

- Local checks skipped (--skip-checks).
- **Skip reason:** 57 legacy files deleted with zero Python logic changes; 480 tests confirmed passing in preceding feat(scripts) commit on this branch (same CI run)
- **Skip reason:** Task status file update only; no logic change.


---

## Verification Methodology

**R0 (trivial) -- local checks skipped.**
**Reason:** 57 legacy files deleted with zero Python logic changes; 480 tests confirmed passing in preceding feat(scripts) commit on this branch (same CI run)
**Reason:** Task status file update only; no logic change.
Only git diff scope inventory was collected. No execution evidence.

---

## Summary

Delete HPE_ARCHIVE — Tasks 1-7 porting complete, archive is now scaffolding that must be removed
Close out Task 9 tracking — all subtasks done
62 changes: 62 additions & 0 deletions .github/aiv-evidence/EVIDENCE_CLAUDE.MD.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
# AIV Evidence File (v1.0)

**File:** `CLAUDE.md`
**Commit:** `d25cfda`
**Generated:** 2026-03-28T02:15:14Z
**Protocol:** AIV v2.0 + Addendum 2.7 (Zero-Touch Mandate)

---

## Classification (required)

```yaml
classification:
risk_tier: R0
sod_mode: S0
critical_surfaces: []
blast_radius: "CLAUDE.md"
classification_rationale: "New documentation file only; no executable code"
classified_by: "Miguel Ingram"
classified_at: "2026-03-28T02:15:14Z"
```

## Claim(s)

1. CLAUDE.md created with full aiv commit workflow, E010 false-positive trap, FILE argument constraints, and architecture reminders
2. Loaded automatically by Claude Code at session start — no need to repeat instructions each session
3. No existing tests were modified or deleted during this change.

---

## Evidence

### Class E (Intent Alignment)

- **Link:** [https://github.com/ImmortalDemonGod/flashcore/blob/bd7cdab/.taskmaster/tasks/task_009.md](https://github.com/ImmortalDemonGod/flashcore/blob/bd7cdab/.taskmaster/tasks/task_009.md)
- **Requirements Verified:** Task 9.2: Document project conventions and workflow constraints

### Class B (Referential Evidence)

**Scope Inventory** (SHA: [`d25cfda`](https://github.com/ImmortalDemonGod/flashcore/tree/d25cfda8b26e5db7b9daccd0c08e7adc345a8266))

- [`CLAUDE.md#L1-L164`](https://github.com/ImmortalDemonGod/flashcore/blob/d25cfda8b26e5db7b9daccd0c08e7adc345a8266/CLAUDE.md#L1-L164)

### Class A (Execution Evidence)

- Local checks skipped (--skip-checks).
- **Skip reason:** New documentation file; no logic change.


---

## Verification Methodology

**R0 (trivial) -- local checks skipped.**
**Reason:** New documentation file; no logic change.
Only git diff scope inventory was collected. No execution evidence.

---

## Summary

Add CLAUDE.md so AI assistant sessions start with full project context
63 changes: 63 additions & 0 deletions .github/aiv-evidence/EVIDENCE_README.MD.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
# AIV Evidence File (v1.0)

**File:** `README.md`
**Commit:** `7e2cf5d`
**Previous:** `6e096b8`
**Generated:** 2026-03-28T02:24:44Z
**Protocol:** AIV v2.0 + Addendum 2.7 (Zero-Touch Mandate)

---

## Classification (required)

```yaml
classification:
risk_tier: R0
sod_mode: S0
critical_surfaces: []
blast_radius: "README.md"
classification_rationale: "Documentation removal only; no executable code"
classified_by: "Miguel Ingram"
classified_at: "2026-03-28T02:24:44Z"
```

## Claim(s)

1. Migration guide section removed — one-time internal concern, not useful to general readers
2. Status/component table removed — internal project tracking, not useful to library evaluators
3. No existing tests were modified or deleted during this change.

---

## Evidence

### Class E (Intent Alignment)

- **Link:** [https://github.com/ImmortalDemonGod/flashcore/blob/bd7cdab/.taskmaster/tasks/task_009.md](https://github.com/ImmortalDemonGod/flashcore/blob/bd7cdab/.taskmaster/tasks/task_009.md)
- **Requirements Verified:** Task 9.2: README should serve external readers, not internal project tracking

### Class B (Referential Evidence)

**Scope Inventory** (SHA: [`7e2cf5d`](https://github.com/ImmortalDemonGod/flashcore/tree/7e2cf5d676cf41ec157850b8240a59147b2fcde2))

- [`README.md#L1-L221`](https://github.com/ImmortalDemonGod/flashcore/blob/7e2cf5d676cf41ec157850b8240a59147b2fcde2/README.md#L1-L221)

### Class A (Execution Evidence)

- Local checks skipped (--skip-checks).
- **Skip reason:** Documentation removal only; no logic change.


---

## Verification Methodology

**R0 (trivial) -- local checks skipped.**
**Reason:** Documentation removal only; no logic change.
Only git diff scope inventory was collected. No execution evidence.

---

## Summary

Strip internal project-management content from README
73 changes: 73 additions & 0 deletions .github/aiv-packets/PACKET_task_9_readme_cleanup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
# AIV Verification Packet (v2.2)

## Identification

| Field | Value |
|-------|-------|
| **Repository** | github.com/ImmortalDemonGod/aiv-protocol |
| **Change ID** | task-9-readme-cleanup |
| **Commits** | `1ea3f4f` |
| **Head SHA** | `1ea3f4f` |
| **Base SHA** | `7e2cf5d` |
| **Created** | 2026-03-28T02:24:48Z |

## Classification

```yaml
classification:
risk_tier: R0
sod_mode: S0
critical_surfaces: []
blast_radius: component
classification_rationale: "R0: pure documentation removal, no executable code modified or added"
classified_by: "Miguel Ingram"
classified_at: "2026-03-28T02:24:48Z"
```

## Claims

1. Migration guide section removed — one-time internal concern, not useful to general readers
2. Status/component table removed — internal project tracking, not useful to library evaluators
3. No existing tests were modified or deleted during this change.

---

## Evidence References

| # | Evidence File | Commit SHA | Classes |
|---|---------------|------------|---------|
| 1 | EVIDENCE_README.MD.md | `1ea3f4f` | A, B, E |



### Class B (Referential Evidence)

**Scope Inventory** (from 1 file references across evidence files)

- `README.md#L1-L221`

### Class E (Intent Alignment)

- https://github.com/ImmortalDemonGod/flashcore/blob/bd7cdab/.taskmaster/tasks/task_009.md
— Task 9.2: README must document installation, usage, architecture, constraints accurately and serve external readers

---

## Verification Methodology

**Zero-Touch Mandate:** Verifier inspects artifacts only.
Evidence was collected by `aiv commit` during the change lifecycle.
Packet generated by `aiv close`.

---

## Known Limitations

- Evidence references point to Layer 1 evidence files at specific commit SHAs.
Use `git show <sha>:.github/aiv-evidence/<file>` to retrieve.

---

## Summary

Change 'task-9-readme-cleanup': 1 commit(s) across 1 file(s).
118 changes: 118 additions & 0 deletions .github/aiv-packets/PACKET_task_9_readme_quality.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,118 @@
# AIV Verification Packet (v2.2)

## Identification

| Field | Value |
|-------|-------|
| **Repository** | github.com/ImmortalDemonGod/aiv-protocol |
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot Mar 28, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Incorrect repository name.

The repository field shows github.com/ImmortalDemonGod/aiv-protocol, but all other references in this PR (evidence files, task links, scope inventory URLs) point to ImmortalDemonGod/flashcore. This appears to be a copy-paste error.

📝 Proposed fix 
-| **Repository** | github.com/ImmortalDemonGod/aiv-protocol |
+| **Repository** | github.com/ImmortalDemonGod/flashcore |
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
| **Repository** | github.com/ImmortalDemonGod/aiv-protocol |
| **Repository** | github.com/ImmortalDemonGod/flashcore |
🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In @.github/aiv-packets/PACKET_task_9_readme_quality.md at line 7, Update the
repository entry in PACKET_task_9_readme_quality.md: replace the incorrect value
"github.com/ImmortalDemonGod/aiv-protocol" in the table row for **Repository**
with the correct repository "github.com/ImmortalDemonGod/flashcore" so the
README matches the other PR references.

| **Change ID** | task-9-readme-quality |
| **Commits** | `6e096b8`, `d25cfda`, `0ffef18` |
| **Head SHA** | `0ffef18` |
| **Base SHA** | `ed9be5d` |
| **Created** | 2026-03-28T02:15:18Z |

## Classification

```yaml
classification:
risk_tier: R1
sod_mode: S0
critical_surfaces: []
blast_radius: component
classification_rationale: "R0/R1 mix: pure documentation and status-tracking changes only. No executable code added or modified."
classified_by: "Miguel Ingram"
classified_at: "2026-03-28T02:15:18Z"
```

## Claims

1. All stale 'in progress' references to CLI and Hub implementation removed
2. Status table updated: all 9 tasks complete; SVP cognitive layer correctly noted as still in progress
3. Quick Start section added so first-time readers have a working path in under 60 seconds
4. Key Features bullet for lightweight runtime now names the excluded packages explicitly
5. Security features (secret detection, HTML sanitization) documented in Key Features
6. Redundant CLI command block consolidated into a single workflow table
7. Architecture section removes stale '(in progress)' qualifier from Hub description
8. AIV Case Study section updated: contradictory status bullets replaced with accurate state table
9. No existing tests were modified or deleted during this change.
10. task_009.md status updated to done; subtasks 9.1, 9.2, 9.3 all marked done
11. CLAUDE.md created with full aiv commit workflow, E010 false-positive trap, FILE argument constraints, and architecture reminders
12. Loaded automatically by Claude Code at session start — no need to repeat instructions each session

---

## Evidence References

| # | Evidence File | Commit SHA | Classes |
|---|---------------|------------|---------|
| 1 | EVIDENCE_README.MD.md | `6e096b8` | A, B, E |
| 2 | EVIDENCE_.TASKMASTER_TASKS_TASK_009.MD.md | `d25cfda` | A, B, E |
| 3 | EVIDENCE_CLAUDE.MD.md | `0ffef18` | A, B, E |



### Class E (Intent Alignment)

- https://github.com/ImmortalDemonGod/flashcore/blob/bd7cdab/.taskmaster/tasks/task_009.md
— Task 9.2: README must document installation, usage, architecture, constraints, and migration guide accurately; Task 9.3: verification checklist confirmed all-complete

---

### Class B (Referential Evidence)

**Scope Inventory** (from 33 file references across evidence files)

- `README.md#L8-L12`
- `README.md#L16`
- `README.md#L18-L21`
- `README.md#L23-L24`
- `README.md#L26-L27`
- `README.md#L29-L30`
- `README.md#L32-L34`
- `README.md#L38`
- `README.md#L40-L53`
- `README.md#L55`
- `README.md#L57`
- `README.md#L59`
- `README.md#L61-L67`
- `README.md#L81`
- `README.md#L84-L87`
- `README.md#L92`
- `README.md#L94-L125`
- `README.md#L137`
- `README.md#L145`
- `README.md#L148`
- `README.md#L150`
- `README.md#L155`
- `README.md#L175-L176`
- `README.md#L179`
- `README.md#L184`
- `README.md#L197-L198`
- `README.md#L204-L241`
- `README.md#L243-L245`
- `README.md#L258`
- `README.md#L264`
- `.taskmaster/tasks/task_009.md#L5`
- `.taskmaster/tasks/task_009.md#L47`
- `CLAUDE.md#L1-L164`

---

## Verification Methodology

**Zero-Touch Mandate:** Verifier inspects artifacts only.
Evidence was collected by `aiv commit` during the change lifecycle.
Packet generated by `aiv close`.

---

## Known Limitations

- Evidence references point to Layer 1 evidence files at specific commit SHAs.
Use `git show <sha>:.github/aiv-evidence/<file>` to retrieve.

---

## Summary

Change 'task-9-readme-quality': 3 commit(s) across 3 file(s).
Loading
Loading