Skip to content

chore(sync): reconcile docs #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
codus-async merged 1 commit into from
Oct 10, 2026
Merged

chore(sync): reconcile docs #4

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ Backend note: in `backend/`, the `typescript` package is aliased to the TypeScri

## Specs

Stored in `docs/specs/`. Format: `docs/specs/NNNN-title.md`.
Stored in `docs/specs/`. Format: `docs/specs/NNNN-title/index.md`, with `rationale.md` and `verify.md` beside it.

## Rules

Expand All @@ -61,9 +61,12 @@ Stored in `docs/specs/`. Format: `docs/specs/NNNN-title.md`.
- separation of concerns (hooks hold logic, data holds data, components render view)
- file strictly under 600 lines
- comments only when necessary and single line only
- Domain writes go through `backend/src/lib/repository.ts` (UUID v4 ids from `crypto.randomUUID`, an Activity row for created and updated, closed set columns validated against `backend/src/lib/constants.ts`); default reads filter `deletedAt IS NULL`, and reads that cross a relation filter soft deleted parents
- Day boundaries come from `backend/src/lib/timezone.ts`, which reads the `TIMEZONE` env var (IANA zone, default UTC, an unparseable value fails config load); no other code builds a Date for domain logic

## Git

- Create a new branch for every new feature when /develop is used
- integration: on
- branch prefix: feat/, fix/, chore/
- commit: per-milestone
Expand Down
4 changes: 2 additions & 2 deletions docs/scope/scope.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ _These are recommendations to keep your build orderly, not requirements. Skip an
| B | Backend scaffold | Foundation | in-progress |
| 18 | Stack & architecture | Foundation | in-progress |
| 1 | Coding standards & tooling | Foundation | done |
| 2 | Data model | Foundation | in-progress |
| 2 | Data model | Foundation | done |
| 3 | Design system & UI foundation | Foundation | planned |
| 4 | Auth & roles | Slice 1 | planned |
| 5 | Schedule & meetings | Slice 1 | planned |
Expand Down Expand Up @@ -57,7 +57,7 @@ Capture conventions from the real scaffold, then install lint, format, and pre c
- [x] Check it runs clean: `/test`
Tooling in `package.json`, `.prettierrc.json`, `.husky/pre-commit`, `.husky/commit-msg`, `commitlint.config.js`, `.github/workflows/ci.yml`, `backend/eslint.config.mjs`, `backend/vitest.config.ts`, `AGENTS.md`

### 2. Data model · in-progress
### 2. Data model · done
The core entities every later slice builds on: users and roles, meetings, tasks, contacts, follow ups, pending decisions, attachments, activity for trash.
**Done when:** entities and relationships support every later slice (schedule, tasks, contacts, follow ups, decisions, briefings) without a breaking migration.
- [x] Design it (spec): `/architect data model`
Expand Down
2 changes: 1 addition & 1 deletion docs/specs/0002-domain-data-model/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# 0002. Domain data model

**Date**: 2026-10-10
**Status**: In Progress
**Status**: Accepted

## Summary

Expand Down
Loading