Adopt the project template into this repository #1

Closed
opened 2026-08-18 02:14:36 -05:00 by null · 0 comments
Owner

Period existed as a bare directory holding one file — a 2,527-line V1 specification — with no git repository, no tracker and no documentation convention. Nothing the portfolio relies on could see it: no trust map saying which document owns which answer, no status headers with Review trigger lines, and no way for privacyllc.dev to report on the project at all.

This issue is the adoption itself, following Projects/Template/START-HERE-New-Project.md.

What it covers:

  • git init, and the template's scaffold.sh run into the repository root (never cp -r, which has no never-overwrite protection)
  • the specification moved from Docs/period_tracker_product_plan.md to docs/planning/PRODUCT_PLAN.md, content unchanged, with a status header added
  • every scaffolded document filled in for Period rather than left with <Project> placeholders
  • docs/OPERATIONS.md deleted — an offline Android app is not a deployed service, and an empty runbook reads as one nobody wrote
  • six scripts taken into scripts/, the rest deliberately declined and named in docs/TOOLS.md
  • the three hooks installed in .githooks/, with pre-commit adapted to Gradle
  • the four severity labels and the eight batch milestones created here

Trap worth knowing: docs/DOC_TRUST_MAP.md is written LAST, describing what is actually here rather than what the template says should be. Its whole value is being accurate about the others.

Verify: docs/DOC_TRUST_MAP.md exists and names every document actually present; grep -rnE '<(Project|YYYY-MM-DD|who maintains this)>' docs/ finds nothing outside a fenced example; bash scripts/doc-claims.sh docs/ README.md passes.

Period existed as a bare directory holding one file — a 2,527-line V1 specification — with no git repository, no tracker and no documentation convention. Nothing the portfolio relies on could see it: no trust map saying which document owns which answer, no status headers with Review trigger lines, and no way for privacyllc.dev to report on the project at all. This issue is the adoption itself, following Projects/Template/START-HERE-New-Project.md. What it covers: - `git init`, and the template's `scaffold.sh` run into the repository root (never `cp -r`, which has no never-overwrite protection) - the specification moved from `Docs/period_tracker_product_plan.md` to `docs/planning/PRODUCT_PLAN.md`, content unchanged, with a status header added - every scaffolded document filled in for Period rather than left with `<Project>` placeholders - `docs/OPERATIONS.md` deleted — an offline Android app is not a deployed service, and an empty runbook reads as one nobody wrote - six scripts taken into `scripts/`, the rest deliberately declined and named in `docs/TOOLS.md` - the three hooks installed in `.githooks/`, with `pre-commit` adapted to Gradle - the four severity labels and the eight batch milestones created here Trap worth knowing: `docs/DOC_TRUST_MAP.md` is written LAST, describing what is actually here rather than what the template says should be. Its whole value is being accurate about the others. Verify: `docs/DOC_TRUST_MAP.md` exists and names every document actually present; `grep -rnE '<(Project|YYYY-MM-DD|who maintains this)>' docs/` finds nothing outside a fenced example; `bash scripts/doc-claims.sh docs/ README.md` passes.
null added this to the Batch 01 — Foundation milestone 2026-08-18 02:14:36 -05:00
null closed this issue 2026-08-18 02:16:52 -05:00
Sign in to join this conversation.
No Label
P0
P1
P2
release-blocker
No project
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: null/Privacy-Period-Tracker#1
No description provided.