docs: Overhaul README and consolidate operational docs
This commit is contained in:
parent
b1d11cd84b
commit
c66ff636ec
2 changed files with 939 additions and 146 deletions
|
|
@ -86,48 +86,3 @@ Genome-level operations are governed by the genome's `AGENTS.md`, not this file.
|
|||
- Concepts in genome-X that should link to genome-Y but don't.
|
||||
3. Report findings. Do not modify any files.
|
||||
4. For each finding: create a conflict note in the genome where resolution belongs, following that genome's §Conflict procedure.
|
||||
|
||||
---
|
||||
|
||||
## Reference Operations
|
||||
|
||||
### Add a genome
|
||||
```bash
|
||||
make add-genome NAME=genome-newname DESC="Domain description"
|
||||
```
|
||||
Then update the architecture diagram in this file.
|
||||
|
||||
### Sync submodules
|
||||
```bash
|
||||
make sync
|
||||
```
|
||||
|
||||
### Update core-karpathy reference
|
||||
```bash
|
||||
git submodule update --remote core-karpathy
|
||||
git add core-karpathy
|
||||
git commit -m "chore: update core-karpathy to latest gist"
|
||||
git push
|
||||
```
|
||||
|
||||
### Clone (full)
|
||||
```bash
|
||||
git clone --recurse-submodules \
|
||||
{{FORGEJO_URL}}/{{FORGEJO_USER}}/{{MASTER_REPO}}.git
|
||||
```
|
||||
After cloning, unlock each genome on the host before starting an agent session.
|
||||
|
||||
### Key rotation (emergency)
|
||||
If a key is compromised: `gcrypt_rotate_key "<genome>"` from project root.
|
||||
Update the Vaultwarden Secure Note with the new base64-encoded key.
|
||||
Revoke access from previous key holders.
|
||||
|
||||
### Key registry
|
||||
|
||||
| Genome | Vaultwarden Secure Note | Temp key file |
|
||||
|--------|------------------------|---------------|
|
||||
| genome-dev | `genome-dev key` | `keys/genome-dev.key` |
|
||||
| genome-finance | `genome-finance key` | `keys/genome-finance.key` |
|
||||
| genome-homelab | `genome-homelab key` | `keys/genome-homelab.key` |
|
||||
|
||||
Temp key files in `keys/` are post-export only. Delete after upload to Vaultwarden.
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue