summaryrefslogtreecommitdiff
path: root/CLAUDE.md
diff options
context:
space:
mode:
authorPeter Stone <thepeterstone@gmail.com>2026-03-22 23:45:19 +0000
committerPeter Stone <thepeterstone@gmail.com>2026-03-22 23:45:19 +0000
commit8abc63efdbc0bb96cd6c9aa99d6e9166e0bcabae (patch)
treef4d6a082eed9b10bc67436a3ca5188e0182961eb /CLAUDE.md
parent11b905fd437d651b2e39745aa82a5dd36f70331e (diff)
chore: unify and centralize agent configuration in .agent/
Diffstat (limited to 'CLAUDE.md')
-rw-r--r--CLAUDE.md76
1 files changed, 9 insertions, 67 deletions
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 <id>` — 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.