docs: add CLAUDE.md, refresh AGENTS.md for beta-stage accuracy #95

Merged

ValleyGeek merged 1 commit from 0.1.32/agents-docs-update into main

2026-06-17 01:20:20 +00:00

Grok commented

2026-06-17 01:09:06 +00:00

Member

Summary

Adds CLAUDE.md with build/lint/test commands and an architecture overview (data layer, duplicate-tag model, threading contract, UI workbenches, packaging) that complements AGENTS.md's process rules.
Corrects stale/inaccurate content in AGENTS.md:
- Duplicate tags are F-DUPE_# / V-DUPE_# (independent counters per prefix); legacy DUPE-FILE_ / DUPE_ / Dupe_ prefixes are still recognized but no longer created. The doc previously described a single Dupe_XXXX scheme.
- Rotation (DR-002) is not stored in the DB — it's written to the file after a short idle debounce and the thumbnail is regenerated. The doc had this backwards (said rotation was DB-only).
- The non-goals list now matches docs/TECHNICAL_OUTLINE.md.
- Removes the "Mandatory Process: The 13-PR Plan" section now that the app is feature-complete beta; DESIGN.md's PR-by-PR history remains as a historical record only, not a process for new work.

No application code changed — ./scripts/compiled-inputs-changed.sh origin/main exits 1, so no VERSION bump or CHANGELOG.md entry.

Test plan

Docs-only change; no src//resources//pyproject.toml touched.
Confirmed duplicate-tag and rotation corrections against db/models.py, core/worker_utils.py, and docs/DECISIONS.md (DR-002, DR-006, DR-007, DR-010).

## Summary - Adds `CLAUDE.md` with build/lint/test commands and an architecture overview (data layer, duplicate-tag model, threading contract, UI workbenches, packaging) that complements `AGENTS.md`'s process rules. - Corrects stale/inaccurate content in `AGENTS.md`: - Duplicate tags are `F-DUPE_#` / `V-DUPE_#` (independent counters per prefix); legacy `DUPE-FILE_` / `DUPE_` / `Dupe_` prefixes are still recognized but no longer created. The doc previously described a single `Dupe_XXXX` scheme. - Rotation (DR-002) is **not** stored in the DB — it's written to the file after a short idle debounce and the thumbnail is regenerated. The doc had this backwards (said rotation was DB-only). - The non-goals list now matches `docs/TECHNICAL_OUTLINE.md`. - Removes the "Mandatory Process: The 13-PR Plan" section now that the app is feature-complete beta; `DESIGN.md`'s PR-by-PR history remains as a historical record only, not a process for new work. No application code changed — `./scripts/compiled-inputs-changed.sh origin/main` exits 1, so no `VERSION` bump or `CHANGELOG.md` entry. ## Test plan - [x] Docs-only change; no `src/`/`resources/`/`pyproject.toml` touched. - [x] Confirmed duplicate-tag and rotation corrections against `db/models.py`, `core/worker_utils.py`, and `docs/DECISIONS.md` (DR-002, DR-006, DR-007, DR-010).

Grok added 1 commit

2026-06-17 01:09:06 +00:00

docs: add CLAUDE.md, refresh AGENTS.md for beta-stage accuracy

Linux AppImage / build-release (push) Failing after 16s

Details

Windows Release / build-release (push) Has been cancelled

Details

6e845572f4

CLAUDE.md gives Claude Code the build/test/architecture context that
complements AGENTS.md's mandatory rules.

AGENTS.md corrections:
- duplicate tags are F-DUPE_#/V-DUPE_# (legacy DUPE-FILE_/DUPE_/Dupe_
  still recognized), not plain Dupe_XXXX
- rotation (DR-002) is written to the file after a debounce, not
  stored in the DB - the doc had this backwards
- non-goals list now matches docs/TECHNICAL_OUTLINE.md
- removed the "Mandatory Process: The 13-PR Plan" section now that
  the app is feature-complete beta; DESIGN.md's PR history remains as
  a historical record only

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Claude force-pushed 0.1.32/agents-docs-update from 6e845572f4

Linux AppImage / build-release (push) Failing after 16s

Details

Windows Release / build-release (push) Has been cancelled

Details

to 4fc9d4b70c

Linux AppImage / build-release (push) Failing after 12s

Details

Windows Release / build-release (push) Has been cancelled

Details

2026-06-17 01:14:39 +00:00

Compare