==NOT PART OF PROMPT: DO NOT USE THIS WITHOUT THE TECHNICAL KNOWLEDGE TO UNDERSTAND WHAT IT DOES!== ## Who I Am I'm Eric (eric@ejattorney.com). I'm building **Forward Assist** as a personal project. I work from a MacBook Pro M1 with SSH keys for most major servers on the network. **My preferences:** Brief, direct answers. No stuffy/formal language. "Humanized" writing — conversational, not corporate. Less is more. Don't over-explain unless I ask for details. **Writing voice:** When drafting any documents, wiki pages, communications, or written content, Claude writes as me (Eric) — first person. Use "I", "we", "our", not "you" or "the user." The output should read like I wrote it myself. --- ## What Forward Assist Is > *To be defined — project concept pending initial planning session.* --- ## Architecture > *To be defined.* --- ## Tech Stack > *To be determined.* --- ## Infrastructure ### Relevant Servers | Server | IP | Role | |--------|----|------| | Ragnar (Proxmox host) | 192.168.1.107 | Hypervisor — runs all LXCs/VMs | | Home Assistant (Ares) | 192.168.1.140 | Automation hub, HA OS | | Infrastructure LXC (104) | 192.168.1.204 | Gitea, wiki (Outline), other infra | | Frigate LXC (108) | 192.168.1.211 | NVR with dual Coral TPUs | ### Access | Service | Access Method | |---------|---------------| | Ragnar SSH | `ssh ragnar` (key-based, root) | | Home Assistant Web | http://192.168.1.140:8123 or https://home.jfamily.cloud | | Home Assistant SSH | Key-based, root | | Home Assistant CLI | `hass-cli` (env vars in ~/.zshrc) | | Gitea Web | http://192.168.1.204:3000 (user: eric) | | Gitea SSH | `ssh git@git.jfamily.io` (key-based, alias in ~/.ssh/config) | | Gitea API | http://192.168.1.204:3000/api/v1/ | | Wiki (Outline) | https://wiki.jfamily.io | | Wiki API | https://wiki.jfamily.io/api/ (Bearer: ol_api_yHXypRyqf4CscWDzPluGfPev9GhdFg6mwrXwkT) | ### Network Context - **Main LAN:** 192.168.1.0/24 (J-Home) - **IoT VLAN:** 192.168.4.0/24 (J-IoT, VLAN 4) - **Protect VLAN:** 192.168.30.0/24 (J-Protect, VLAN 30) - **Gateway:** UDM-SE (192.168.1.1) --- ## Git Repo > *To be created once project concept is defined.* **Gitea:** git@git.jfamily.io (SSH, port 2222) - Web: http://192.168.1.204:3000 (user: eric) - To generate API tokens: `ssh ragnar "pct exec 104 -- docker exec -u git gitea gitea admin user generate-access-token --username eric --token-name --scopes all"` ### File Manifest | File | Purpose | |------|---------| | `CLAUDE_ACCESS_PROMPT.md` | Wiki & Gitea access details | | `CLAUDE.md` | Quick-reference project context for Claude Code | | `MASTER_PROMPT.md` | This file — full session context | ### Working Directory (Mac) `/Users/jungbauerfamily/Library/Mobile Documents/com~apple~CloudDocs/Claude Working Folder/Forward Assist/` --- ## Documentation — Wiki Is the Source of Truth **Wiki collection:** Forward Assist (https://wiki.jfamily.io) **Wiki API base:** `https://wiki.jfamily.io/api/` **Auth header:** `Authorization: Bearer ol_api_yHXypRyqf4CscWDzPluGfPev9GhdFg6mwrXwkT` **Collection ID:** `d1f85b19-030d-4a39-a6fd-317d6825fdfe` ### Wiki Documents | Document | ID | Purpose | |----------|----|---------| | Master Prompt | 82ea3344-b55e-46d9-bcb6-a03eec252261 | Session context (this file mirrors it) | | Project Design Reference (PDR) | f33885c7-261f-46ed-9ff9-5348615b5b2e | Full project spec | | Claude Code Log | 7ce13c60-dc93-4af3-85ae-8e407c5ca66b | Session-by-session work log | | User Manual | ebc0b8ea-8e4b-4e35-9817-77d31c0ed3ea | End-user documentation | | Changelog | 7a3b0ae0-3d0a-4433-aca8-e494f9fd8fa2 | Dated change entries | | The ScratchPad | d15c7e5d-b6f5-4e2a-aecb-a3782f8dc694 | Informal notes/workspace | | Bugs! | 172adb16-ca91-4005-89d4-5ff0c90221e2 | Bug tracking (child of ScratchPad) | | Change Orders! | cdaff737-aa78-4d85-b28b-8745968d9294 | Design deviations (child of ScratchPad) | | Feature Ideas! | 3d5e036f-33c3-4bea-b129-74e5464ed182 | Future ideas (child of ScratchPad) | ### Wiki Update Rule Any time changes are made to the project, Claude MUST update the relevant wiki documentation: - **Changelog** — Log what changed and when - **PDR** — Update if architecture or technical design changed - **Claude Code Log** — Log session work - **Bugs!** — Track any issues discovered - **Change Orders!** — Log any deviations from the PDR - **Feature Ideas!** — Capture new ideas that come up during work ### Wiki API Quick Reference ```bash # List docs in collection curl -X POST "https://wiki.jfamily.io/api/documents.list" \ -H "Authorization: Bearer ol_api_yHXypRyqf4CscWDzPluGfPev9GhdFg6mwrXwkT" \ -H "Content-Type: application/json" \ -d '{"collectionId": "d1f85b19-030d-4a39-a6fd-317d6825fdfe"}' # Update a document curl -X POST "https://wiki.jfamily.io/api/documents.update" \ -H "Authorization: Bearer ol_api_yHXypRyqf4CscWDzPluGfPev9GhdFg6mwrXwkT" \ -H "Content-Type: application/json" \ -d '{"id": "", "text": ""}' # Create a new document curl -X POST "https://wiki.jfamily.io/api/documents.create" \ -H "Authorization: Bearer ol_api_yHXypRyqf4CscWDzPluGfPev9GhdFg6mwrXwkT" \ -H "Content-Type: application/json" \ -d '{"title": "...", "text": "...", "collectionId": "d1f85b19-030d-4a39-a6fd-317d6825fdfe", "publish": true}' ``` --- ## Current Focus > *Project concept pending — awaiting initial planning session with Eric.*