Saturday, 4 July 2026 — Sunday, 5 July 2026
Session summary: doc/ folder restructure, project outline, coding guidelines, history index, CLAUDE.md cleanup.
The history/ folder moved to doc/history/ and
history/styles.css moved to doc/_assets_/styles.css
to serve as a shared stylesheet for all documentation. All existing history
entry CSS paths were updated accordingly. The new doc/ root is
the single home for all project documentation going forward.
Created doc/outline/index.html — the main developer reference,
readable by both humans and agent contributors. It contains three sections:
a project outline (what Roject is, current state, loose todos), a technical
implementation overview (backend, frontend, shared library with tags), and
an actions section that defines repeatable tasks for Update History and
Update Documentation.
Created doc/outline/coding-guidelines/index.html based on the
rokojori action library guidelines. Covers formatting (brackets on new line,
2-space soft tabs, spacing around operators), naming (camelCase, uppercase
for class names and statics, underscore prefix for internal members), and
design rules (static factory methods, early return, extract to named
functions, if/else over switch, initialise all members). Includes a
TypeScript example. C# and PHP examples were omitted.
Created doc/history/index.html — a chronological list of all
session entries, most recent first, each with a one-line summary and a link
to the full entry. This file is updated by the Update History action at the
end of every session.
Added a, code, pre, and
pre code styles to doc/_assets_/styles.css to
support the coding guidelines page. Inline code gets the accent colour on a
dark tag background; code blocks get a darker background with monospace font
and horizontal scrolling.
Stripped CLAUDE.md down to a single line pointing to
doc/outline/index.html. All content that was in CLAUDE.md
(tech stack, conventions, IDs, TypeScript setup, commands, project structure)
is now in the outline with more detail.
doc/, not project root
Keeping all documentation under a single doc/ directory makes the
root cleaner and gives history and outline a shared home without polluting the
server or source directories.
The "what still needs work" card in the outline is intentionally written as prose, not a checklist. It is updated on the go as features are added rather than maintained as a formal task tracker.
The actions section in the outline describes repeatable tasks (Update History, Update Documentation) with enough detail that an agent can execute them correctly without asking follow-up questions: which file to create, what CSS path to use, what to update after.
doc/_assets_/styles.css — shared stylesheet for all doc pages
doc/outline/index.html — main developer documentation
doc/outline/coding-guidelines/index.html — formatting and naming rules
doc/history/index.html — session history index
doc/history/YYYY/MM-Month/DD-Day/index.html — individual session entries
CLAUDE.md — one-line pointer to doc/outline/index.html