eric/forward-assist
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
forward-assist/MASTER_PROMPT.md
T

5.3 KiB
Raw Permalink Blame History

==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 <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

# 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": "<doc-id>", "text": "<full markdown content>"}'

# 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.

Reference in New Issue View Git Blame Copy Permalink