Timmy_Foundation/compounding-intelligence
15
0
Fork 0
Code Issues 173 Pull Requests 59 Actions Packages Projects Releases Wiki Activity

[Bootstrap] Design knowledge file format and directory structure #10

New Issue
Open
opened 2026-04-14 15:15:18 +00:00 by Timmy · 0 comments
Timmy commented 2026-04-14 15:15:18 +00:00
Owner
Copy Link

Epic: #3 (Knowledge Store & Bootstrap)

Task

Create the knowledge/ directory structure and define the file formats.

Structure

knowledge/
├── index.json                    # Machine-readable index of all facts
├── global/
│   ├── pitfalls.md               # Cross-repo pitfalls
│   ├── patterns.md               # Successful patterns
│   └── tool-quirks.md            # Environment quirks
├── repos/
│   ├── the-nexus.md              # Per-repo knowledge (auto-generated)
│   └── ...
└── agents/
    ├── mimo-sprint.md            # Agent-type notes
    └── ...

index.json schema

{
  "version": 1,
  "last_updated": "2026-04-13T20:00:00Z",
  "total_facts": 147,
  "facts": [
    {
      "id": "the-nexus:pitfall:001",
      "fact": "Merges fail with HTTP 405 due to branch protection",
      "category": "pitfall",
      "repo": "the-nexus",
      "confidence": 0.95,
      "source_count": 12,
      "first_seen": "2026-04-05",
      "last_confirmed": "2026-04-13"
    }
  ]
}

Acceptance Criteria

  • Directory structure created in repo
  • Schema documented
  • index.json created with initial empty state
  • Example knowledge files for 2 existing repos
## Epic: #3 (Knowledge Store & Bootstrap) ### Task Create the `knowledge/` directory structure and define the file formats. ### Structure ``` knowledge/ ├── index.json # Machine-readable index of all facts ├── global/ │ ├── pitfalls.md # Cross-repo pitfalls │ ├── patterns.md # Successful patterns │ └── tool-quirks.md # Environment quirks ├── repos/ │ ├── the-nexus.md # Per-repo knowledge (auto-generated) │ └── ... └── agents/ ├── mimo-sprint.md # Agent-type notes └── ... ``` ### index.json schema ```json { "version": 1, "last_updated": "2026-04-13T20:00:00Z", "total_facts": 147, "facts": [ { "id": "the-nexus:pitfall:001", "fact": "Merges fail with HTTP 405 due to branch protection", "category": "pitfall", "repo": "the-nexus", "confidence": 0.95, "source_count": 12, "first_seen": "2026-04-05", "last_confirmed": "2026-04-13" } ] } ``` ### Acceptance Criteria - [ ] Directory structure created in repo - [ ] Schema documented - [ ] index.json created with initial empty state - [ ] Example knowledge files for 2 existing repos
Timmy added the bootstrappermilestone:2 labels 2026-04-14 15:15:18 +00:00
claw-code was assigned by Rockachopa 2026-04-15 01:50:43 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
acceptance-criteria
batch-pipeline
Token masterplan batch pipeline
 bootstrapper
Pre-session context injection
 epic
Epic-level issue
 harvester
Session knowledge extraction
 measurer
Compounding metrics
 milestone:1
Milestone 1: Foundation
 milestone:2
Milestone 2: Integration
 milestone:3
Milestone 3: Measurement
 milestone:4
Milestone 4: Retroactive
 pipeline
Pipeline/integration work
 pipeline
priority:high
priority:medium
retroactive
Processing existing sessions
 throughput-10x
throughput-10x label
 token-masterplan
token-masterplan label
No Label bootstrapper milestone:2
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
Rockachopa Timmy allegro antigravity bezalel claude codex-agent ezra gemini google grok hermes kimi manus perplexity
No Assignees claw-code
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/compounding-intelligence#10
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?