jpmschweitzerandClaude Opus 4.5
a4aaea33b8
- Rename features/dashboard → features/front_hall - Update routes: /, /control-room, /parlor, /settings - Update navigation to 4 rooms (removed chat tab - will be omnipresent dock) - Add docs/UI_LAYOUT.md with wireframes and responsive specs - Update ARCHITECTURE.md and PLAN.md to reflect room structure Directory structure now mirrors "Rooms of the Estate" UI navigation: - front_hall/ (dashboard) - control_room/ (infrastructure - containers, stacks, etc.) - parlor/ (home automation) - library/ (future) - study/ (future, hidden) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2.9 KiB
2.9 KiB
LLM Agent Instructions
This document contains instructions and documentation references for AI assistants working with this codebase.
📖 Important: Before working on this project, read PHILOSOPHY.md to understand the system vision, architectural patterns, and design goals. All development should work towards realizing those patterns.
AGENTS.md
Start every session by reading this file. This file outlines the operational protocols, coding standards, and architectural decisions for this Flutter project.
1. Agent Operational Protocols
🧠 Work Patterns (Plan-Act-Reflect)
- Plan: Before writing code, briefly outline your plan. Identify which files you will touch and what the side effects might be.
- Act: Execute the changes in small, atomic steps.
- Reflect: After coding, verify your work. Did you break existing tests? Did you add new tests?
🌐 Internal Service Access
- git.schweitz.net: Access via
http://localhost:3002(direct Gitea) to bypass Authentik SSO- Example:
curl http://localhost:3002/jpmschweitzer/library-desk/raw/branch/main/README.md - Public repos are readable without authentication
- Related repos: ,
core-api,tatlock,library-desk,scheduler,portainer-core
- Example:
🐳 Deployment & Infrastructure
- Full stack documentation: Available in the
portainer-corerepo- Access:
curl http://localhost:3002/jpmschweitzer/portainer-core/raw/branch/main/CONTAINERS.md - Contains: All service ports, URLs, Redis DB allocations, external domains
- Access:
- Tatlock deployment:
- LAN:
http://192.168.86.149:8000 - External:
tatlock.schweitz.net(behind Authentik SSO) - Redis DBs: 1 (memory), 6 (benchmarks)
- LAN:
- Health check:
curl http://192.168.86.149:8000/health
🛡️ Git Discipline
- Commit Messages: Use the Conventional Commits format.
feat: add user login endpointfix: resolve database connection timeoutrefactor: split monolith dependency file
- Atomic Commits: Keep commits small. One logical change = one commit.
- Version Tagging: Every version increment (major.minor.patch, not build count) must have a corresponding git tag.
- Format:
v{major}.{minor}.{patch}(e.g.,v0.3.0) - Tag after updating
pubspec.yamlversion and CHANGELOG - Push tags with
git push --tags
- Format:
🧪 Testing Requirements
- Always add tests for new code before committing. No exceptions.
- Tests should cover the happy path and key edge cases.
- Run
flutter testbefore committing to ensure all tests pass. - For widgets: use widget tests. For business logic: use unit tests.
- Code coverage should not decrease with new commits.
📝 Changelog Maintenance
- Update
CHANGELOG.mdwith every user-facing change. - Format:
## [Unreleased] - YYYY-MM-DDfollowed by### Added,### Changed, or### Fixed.