init: AFS baseline (config + plugins)

This commit is contained in:
scawful
2025-12-30 07:43:27 -05:00
commit 3574cb8538
12 changed files with 430 additions and 0 deletions

13
docs/NARRATIVE.md Normal file
View File

@@ -0,0 +1,13 @@
# Narrative
AFS is a research-only internal system focused on structuring context and workflow
for agentic tools. This repo tracks experiments and implementations; claims should
map to code or docs.
## Source papers (in `~/Documents/Research`)
- `2512.05470v1.pdf` — "Everything is Context: Agentic File System Abstraction for Context Engineering"
- `2512.08296.pdf` — "Towards a Science of Scaling Agent Systems"
## Cognitive protocol references
- `2510.04950v1.pdf` — title not present in metadata (file labeled "ArXiv"); user-noted as theory-of-mind / cognitive protocol related.
- `7799_Quantifying_Human_AI_Syne.pdf` — title not present in metadata; user-noted as theory-of-mind / cognitive protocol related.

18
docs/REPO_FACTS.json Normal file
View File

@@ -0,0 +1,18 @@
{
"name": "afs",
"stage": "prototype",
"is_product": false,
"commercial_intent": "none",
"verified_features": [],
"hard_no": [
"enterprise",
"production-ready",
"platform",
"seamless",
"scalable",
"best-in-class",
"state-of-the-art",
"robust",
"official"
]
}

13
docs/ROADMAP.md Normal file
View File

@@ -0,0 +1,13 @@
# ROADMAP
## Committed
- Minimal module layout + package stubs
- One small utility
## Planned
- Configuration schema
- Basic CLI entry point
## Ideas
- Idea: Status TUI
- Idea: Plugin discovery via ~/.config/afs/plugins

7
docs/STATUS.md Normal file
View File

@@ -0,0 +1,7 @@
# STATUS
Stage: Prototype
Now: package stub; guardrails; minimal config + plugin discovery.
Not yet: CLI/services; full configuration schema validation.
Next: one small utility; smoke-test stub.
Issues: no runtime yet.