mirror of
https://github.com/PR0M3TH3AN/bitblocks.git
synced 2026-10-27 07:50:39 +00:00
Add repo memory layer
Co-Authored-By: Claude Fable 5 <[email protected]>
This commit is contained in:
1 parent
cd33e551e4
commit
d301b4702c
8 files changed
+75
No files matched your search
@@ -0,0 +1,33 @@
|
||||
# Repo Memory
|
||||
|
||||
Curated, reviewed knowledge for coding agents working in this repository.
|
||||
Memory is an accelerator, not a second source of truth.
|
||||
|
||||
## Precedence (highest first)
|
||||
|
||||
1. Source code and tests
|
||||
2. Executable configuration
|
||||
3. Accepted design records / docs
|
||||
4. `AGENTS.md`
|
||||
5. This memory
|
||||
|
||||
If memory conflicts with anything above it, the memory is stale — propose a fix.
|
||||
|
||||
## Topics
|
||||
|
||||
- `memory/architecture.md` — durable architectural decisions and constraints
|
||||
- `memory/conventions.md` — validated conventions not obvious from the code
|
||||
- `memory/lessons.md` — hard-won lessons and recurring landmines
|
||||
- `memory/decisions.jsonl` — structured decision records (one JSON object per line)
|
||||
|
||||
## Write policy
|
||||
|
||||
Agents MAY read everything here and MAY add candidates under `proposals/`
|
||||
(one file per proposal, named `YYYY-MM-DD-<slug>.md`, with evidence links).
|
||||
Agents MUST NOT edit `memory/` directly; trusted memory changes only through
|
||||
reviewed commits that promote a proposal.
|
||||
|
||||
## Prohibited content
|
||||
|
||||
Credentials or secrets, personal data, raw transcripts or tool logs, session
|
||||
TODOs, high-frequency agent state, unverified external claims.
|
||||
@@ -0,0 +1,16 @@
|
||||
# Architecture
|
||||
|
||||
Durable architectural decisions and constraints for this repository.
|
||||
|
||||
## Strict CSP as a hard deployment constraint
|
||||
|
||||
Deployment config serves every path with a strict Content-Security-Policy
|
||||
(`default-src 'none'; script-src 'self'; style-src 'self' 'unsafe-inline'`,
|
||||
plus `frame-ancestors 'none'`, `form-action 'none'`, `object-src 'none'`),
|
||||
alongside `X-Frame-Options: DENY`, `X-Content-Type-Options: nosniff`, and
|
||||
`Referrer-Policy: no-referrer`. Any change must work under this policy: no
|
||||
inline scripts, no CDN or other external origins for scripts, styles, or
|
||||
fonts; images are limited to same-origin and `data:` URIs.
|
||||
|
||||
Authoritative source:
|
||||
- vercel.json
|
||||
@@ -0,0 +1,5 @@
|
||||
# Conventions
|
||||
|
||||
Validated conventions not obvious from the code.
|
||||
|
||||
No entries yet.
|
||||
Whitespace-only changes.
@@ -0,0 +1,5 @@
|
||||
# Lessons
|
||||
|
||||
Hard-won lessons and recurring landmines.
|
||||
|
||||
No entries yet.
|
||||
@@ -0,0 +1,7 @@
|
||||
# Memory proposals
|
||||
|
||||
Agents: drop candidate memories here, one file per proposal, named
|
||||
`YYYY-MM-DD-<slug>.md`. State the claim, the evidence (file paths, commits,
|
||||
test results), and why it is durable. A human reviews and either promotes it
|
||||
into `../memory/` in a reviewed commit or deletes it. Nothing in this
|
||||
directory is trusted context.
|
||||
Reference in new issue
Block a user