blob: df34529144e05660abc34ae829224492bfe0e01e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
|
---
description: FIXED — MASTER primary (rules+docs); ./* secondary; no documents in ./* (operator-only).
alwaysApply: true
---
# MASTER-REPO governance (IMMUTABLE)
**Authority:** Operator only. Agents **must not** edit this file or `../.cursor/hooks/refresh-master-ai-rules.sh`.
**Standard:** Fixed for every path under `/home/akb/Code/10-PROJECTS/` (`./*`). Centralized development — not overridable by agents or local rules.
## Primary vs secondary (always)
| Tier | Scope | Role |
|------|-------|------|
| **PRIMARY** | MASTER-REPO (`0-RESEARCHES`) | Rules **and** documents — sole authority |
| **SECONDARY** | `./*` (this tree) | Code/work only — never overrides MASTER |
**MASTER-REPO goes first in rules and documents — always.** Local `./*` is secondary — always.
## Precedence (strict)
1. **MASTER** `/home/akb/0-RESEARCHES/AGENT-INDEX.md` — law entry (legacy: `/home/akb/Code/0-RESEARCHES/`)
2. **MASTER** `.cursor/rules/*.mdc` — AI rules referenced from AGENT-INDEX
3. **Local** `.cursor/rules/*` (except this file) — product hints only; **never** override MASTER
## No documents in `./*` (FIXED)
Agents **must not create, edit, or extend documentation** anywhere under `./*`:
| Forbidden | Examples |
|-----------|----------|
| New or changed `.md` | `docs/`, `README.md`, `AGENTS.md`, `CHANGELOG.md`, investigations |
| Shipped doc sync | Editing frozen `docs/` in this repo |
| Research notes | Any write-up belonging in MASTER `projects/max25-stack/` |
| Allowed in `./*` | Examples |
|------------------|----------|
| **Code** | `stacks/`, `plugins/`, `scripts/`, `include/`, `share/`, tests, build |
| **Code-tied config** | `.ini.example` only when a code change requires it |
| **Inline code comments** | In source files — not standalone documents |
All documentation → **MASTER-REPO only** (AGENT-INDEX §0.5). Operator may change this rule; agents may not.
## MASTER pull scope (sync hook)
Auto-sync pulls **rules only** from MASTER: `AGENT-INDEX.md` + `.cursor/rules/*.mdc`.
For **writing** documentation: go to MASTER — never `./*`.
## 60-minute resync (active work)
Hook `../.cursor/hooks/refresh-master-ai-rules.sh` → `.cursor/cache/master-ai-rules.snapshot.md` every **60 minutes**.
## MASTER path resolution
1. `/home/akb/0-RESEARCHES/`
2. `/home/akb/Code/0-RESEARCHES/` (legacy)
## Slave repo (MAX25-Stack)
Code/work only. Read frozen `docs/` for context — do not author here.
|
