From 8abc63efdbc0bb96cd6c9aa99d6e9166e0bcabae Mon Sep 17 00:00:00 2001 From: Peter Stone Date: Sun, 22 Mar 2026 23:45:19 +0000 Subject: chore: unify and centralize agent configuration in .agent/ --- CLAUDE.md | 76 ++++++++------------------------------------------------------- 1 file changed, 9 insertions(+), 67 deletions(-) (limited to 'CLAUDE.md') diff --git a/CLAUDE.md b/CLAUDE.md index 237fdaa..4140859 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,71 +1,13 @@ -# Task Dashboard — Project Guidelines +# Doot — Agent Instructions -## Overview -A unified web dashboard aggregating Trello, Todoist, PlanToEat, Google Calendar, and Google Tasks. -**Stack:** Go 1.24 + chi router + HTMX + Tailwind CSS + SQLite. +This repository uses a centralized agent configuration. All agents should refer to the following location for rules, standards, and the current worklog: -## Development Standards -See `~/.claude/CLAUDE.md` for methodology (TDD, workflow, state management, efficiency, git practices). -Agent roles defined in `~/.claude/roles/`. +**Primary Source of Truth:** `.agent/config.md` -## Key Documents +## Quick Reference +- **Worklog:** `.agent/worklog.md` +- **Design:** `.agent/design.md` +- **Coding Standards:** `.agent/coding_standards.md` +- **UX Philosophy:** `.agent/ux_philosophy.md` -| Document | Purpose | When to Read | -|----------|---------|--------------| -| `DESIGN.md` | Architecture, features, visual design, dev patterns | Before any significant work | -| `SESSION_STATE.md` | Current task state, next steps | Start of every session | -| `docs/adr/*.md` | Architecture Decision Records | Before implementing features in that area | - -## Essential Commands -- **Run:** `go run cmd/dashboard/main.go` -- **Test:** `go test ./...` -- **Build:** `go build -o dashboard cmd/dashboard/main.go` -- **Deploy:** `./scripts/deploy` (builds with ldflags, syncs locally, restarts service) - -## Debugging -- **Production logs:** `./scripts/logs` — fetches journalctl from the local service - - `./scripts/logs -n 100` last N lines - - `./scripts/logs -f` follow - - `./scripts/logs --since "1 hour ago"` - - Pipe through `grep` to filter: `./scripts/logs -n 500 2>&1 | grep -i error` -- **View bugs:** `./scripts/bugs` — lists open bugs from local production database -- **Resolve bug:** `./scripts/resolve-bug ` — marks a bug as resolved -- **Always check logs first** when debugging reported issues - -## Technical Context -- **Trello is PRIMARY:** Key + Token required in query params. -- **Architecture:** chi router → Handlers (`internal/handlers/`) → Store (`internal/store/sqlite.go`). -- **Errors:** Partial data/cache fallback preferred over hard failure. -- **Full details:** See `DESIGN.md` → Architecture section. - -## Coding Style -- Use concise, idiomatic Go. -- Avoid verbose explanations or comments for self-evident logic. -- Prioritize terminal-based verification over manual code review. -- **Patterns:** See `DESIGN.md` → Development Guide for handler/template patterns. - -## Configuration Reference - -**Required:** -- `TODOIST_API_KEY` — Todoist API key -- `TRELLO_API_KEY` — Trello API key -- `TRELLO_TOKEN` — Trello token -- `DEFAULT_PASS` — Admin password - -**Optional:** -- `DEFAULT_USER` (default: "admin") -- `PLANTOEAT_SESSION` — PlanToEat session cookie -- `PLANTOEAT_API_KEY` — PlanToEat API key -- `GOOGLE_CREDENTIALS_FILE` — OAuth credentials JSON path -- `GOOGLE_CALENDAR_ID` (default: "primary") — comma-separated for multiple -- `GOOGLE_TASKS_LIST_ID` (default: "@default") -- `WEBAUTHN_RP_ID` — Passkey Relying Party ID (e.g., "doot.terst.org") -- `WEBAUTHN_ORIGIN` — Passkey expected origin (e.g., "https://doot.terst.org") -- `DATABASE_PATH` (default: "./dashboard.db") -- `PORT` (default: "8080") -- `CACHE_TTL_MINUTES` (default: 5) -- `TIMEZONE` (default: "Pacific/Honolulu") -- `TEMPLATE_DIR` (default: "web/templates") -- `STATIC_DIR` (default: "web/static") -- `MIGRATION_DIR` (default: "migrations") -- `DEBUG` (default: false) +Refer to `.agent/config.md` before performing any tasks. -- cgit v1.2.3