Repository navigation
governance document lifecycle
Canonical: docs/governance/safrs_document_lifecycle.md, SAFRS_SPEC.md §13, .safrs/document-registry.json.
| Class | Meaning |
|---|---|
| CANONICAL | current normative truth |
| ACTIVE | current operational/implementation state |
| HISTORICAL | useful history, not current instruction |
| SUPERSEDED | replaced; not normative |
| ARCHIVED | retained, excluded from current decisions |
ADR: PROPOSED → ACCEPTED → SUPERSEDED or REJECTED.
Plan: ACTIVE → COMPLETED → ARCHIVED.
Rules:
- One canonical document ID maps to one current path.
- Superseded documents name their replacement in the registry when a replacement exists.
- Completed execution plans do not become architecture truth automatically.
- Code that changes a documented invariant must update the owning canonical document in the same change set.
- CI validates registry structure and referenced files.
This wiki is not in the document registry. It is derived navigation.
Routing in AGENTS.md between SAFRS:ROUTING:BEGIN/END is generated from the registry by python tools/safrs/generate_routing.py. Do not edit that block by hand.
SAFRS — the Sentra Agent-First Repository Standard — defines how a software repository should be structured, governed, and enforced when autonomous Artificial Intelligence agents perform a substantial share of engineering work by Sentra Artificial Intelligence.
SAFRS v1.1 addresses that problem through five coupled mechanisms:
- a six-layer repository architecture from Trust Boundary to Human Authority;
- a role-based permission model in which capability never implies trust;
- a four-tier risk model with cumulative mandatory controls;
- a multi-agent execution protocol with explicit task states and one mutation owner per bounded scope;
- a knowledge governance model that distinguishes current architecture, historical decisions, execution plans, Git history, and running code.
Built in Indonesia as part of the Sentra Artificial Intelligence ecosystem.
Sentra Artificial Intelligence · Source Repository · Official Website
Dr Ferdi Iskandar — Creator & Maintainer
LinkedIn ·
ORCID ·
Hugging Face ·
Kaggle ·
Medium ·
Substack ·
X ·
Threads
MyPrompt · Sentra Artificial Intelligence · Indonesia
- SentraBot
- Kediri History
- Academic Smartboard
- Avery
- Portfolio Dr. Novia
- Golden Path (legacy demonstrator)
- Control Center
- Capsule template
- Risk model (R0–R3)
- Agent roles and permissions
- Capsule sovereignty
- Multi-agent protocol
- Document lifecycle
- Sensitive paths
- Verification integrity
Lore — how this repository grew
- Schemas (
@safrs/schemas) - Environment (
@safrs/env) - Database (
@safrs/database) - API (
@safrs/api) - UI (
@safrs/ui) - Telemetry (
@safrs/telemetry) - Token (
@sentra/token) - Config (
@safrs/config) - Auth (
packages/auth)
- SAFRS governance checkers
- SAFRS Automation Control Plane
- Gaffer Runtime
- Doctor
- Project wizard
- project-standalone
- Capabilities
- Codegen
- Deps-graph
- Status CLI
- Task CLI