Project handbook: brief, status log, decision notes and operational documentation
Find a file
2026-10-15 21:41:51 -03:00
.forgejo/workflows ci: Forgejo workflows for git.pop.coop 2026-10-15 00:33:00 +00:00
.github ci: security scanning, with the findings read and justified 2026-10-07 18:19:28 +00:00
docs docs: infra, a job silent for 10 min fails on git.pop.coop (keel#177) 2026-10-16 00:31:24 +00:00
.gitignore gitignore: the worktrees agents create for their branches 2026-09-26 20:53:54 +00:00
AGENTS.md docs: ASD-STE100 is the language standard for every project text 2026-10-08 21:02:59 +00:00
BRIEF.md docs: ASD-STE100 is the language standard for every project text 2026-10-08 21:02:59 +00:00
README.md Add the project handbook 2026-09-26 19:57:14 +00:00
STATUS.md status: day two in apply, and turnkeylinux/tracker#2140 fixed in Keel 2026-09-29 19:21:52 +00:00
tools-setup-org.sh Add the project handbook 2026-09-26 19:57:14 +00:00

Keel handbook

Working notes for the Keel Linux project: the standing brief, the running status log, decision notes and the operational documentation for the build host, the public services host and the release pipeline.

This repository is private because it records host addresses, sudo policy and recovery procedures. Material that is safe in public is promoted to the site repository instead of being published from here:

Here Published as
docs/org-plan.md site: organization guidelines
docs/ci-cd.md site: contributing and CI
docs/decisions/ site: decision log, once each note is cleared
docs/brand/ site: brand assets (the SVG master lives here)

Layout

Path What it holds
BRIEF.md the standing brief; read it before touching code
STATUS.md running log, newest section last
docs/decisions/ numbered decision notes, one per direction taken
docs/infra* build host, releases host, recovery, VM provisioning
docs/m0-gate* the equivalence and packing gate and its runs
docs/brand/ mark, lockups, icons, social card
docs/keys/ public keyring and fingerprint; no secret material
repos/ working clones, not tracked here

Code lives in the organization repositories, not in this one.