halkyon/apps/todo/AGENTS.md
Tizian 「ティツィアーン」 1b62c8098c
docs: one repository for every app and shared package (ADR 0015)
The root AGENTS.md holds what applies to every app and package (how
work is done, Serverpod, checks with Melos and the tools, CI); Learn's
own is apps/learn/AGENTS.md, Todo's a note that it is still the
scaffold. The root README introduces the project, Learn's moves to its
folder; LICENSE.md says which licence covers which directory, Todo's
packages unlicensed until decided; one CONTRIBUTING.md. ADR 0015
records the decision; ADR 0014 and 0003 note what moved.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Tizian 「ティツィアーン」 <raisondetredev@pm.me>
2026-10-22 18:11:04 +02:00

1.5 KiB

Halkyon Todo

What holds for every app and package of this repository is in the root AGENTS.md; it applies here in full.

  • Still Serverpod's scaffold (serverpod create, joined the repository on 2026-10-19, ADR 0015): halkyon_todo_server, halkyon_todo_client (generated, never edited) and halkyon_todo_flutter, with the template's greeting endpoint and screens. Since joining: Serverpod 4.0.4 and Dart 3.13 like every package, server-side sessions (ServerSideSessionsConfigFromPasswords, 90 days unused), Serverpod's own email-and-password sign-in still, google_fonts gone (it fetches fonts, which Halkyon never does), and the scaffold's lints (lints, flutter_lints) rather than the root's.
  • To be built on the shared packages, as Learn is: halkyon_base for signing in, the account and the instance's basics (its server configured with HalkyonBase.configure and an app id of its own, which never changes once apps use it), halkyon_app for the instances, sign-in, the gates and sync, halkyon_ui for the look (packages/*/README.md). What it keeps and syncs, and which of Learn's rules it adopts, the developer decides first.
  • serverpod start runs in apps/todo/halkyon_todo_server; .mcp.json's --server-dir names it when a session works on Todo. Its tests need throwaway passwords in its git-ignored config/passwords.yaml (database, serviceSecret, serverSideSessionKeyHashPepper) or from the environment, as CI gives them.