41 lines
1.4 KiB
Markdown
41 lines
1.4 KiB
Markdown
# Repository layout
|
|
|
|
## Core idea
|
|
- ARNES core lives at repository root once installed into a project repo.
|
|
- The source repo of ARNES is not the repo where product work should happen.
|
|
- Real project code lives in `project/` by default.
|
|
- Project-specific rules live in overlays, not in core files.
|
|
|
|
## Main directories
|
|
- `project/` — real app code
|
|
- `backlog/` — ticket list and feature state
|
|
- `work/` — runtime state, history, artifacts
|
|
- `harness/` — workflow, roles, policies, contracts
|
|
- `spec/` — product, tech, acceptance, SDD, BDD source docs
|
|
- `features/` — optional executable BDD runner assets
|
|
- `scripts/` — start, verify, ticket creation, publish, install, runtime status
|
|
- `platforms/` — platform adapters (pi, opencode)
|
|
- `defaults/` — optional starter assets
|
|
- `tests/` — self-tests for the ARNES source repo only
|
|
|
|
## Recommended separation
|
|
- Core ARNES should stay generic.
|
|
- Domain checks go in `scripts/verify.local.sh`.
|
|
- Domain rules go in `AGENTS.local.md`.
|
|
- Real code should not be mixed into `harness/`, `work/`, `backlog/`, or `spec/`.
|
|
- Source-repo self-tests under `tests/` are not part of installed project repos.
|
|
|
|
## Default project shape
|
|
```text
|
|
project/
|
|
├── README.md
|
|
├── templates/
|
|
├── static/
|
|
│ ├── css/
|
|
│ ├── js/
|
|
│ └── images/
|
|
└── ...
|
|
```
|
|
|
|
This shape is only a default. The wizard can target another app directory if needed.
|