ArchiTools/SESSION-GUIDE.md

ArchiTools — Session Guide

Device-agnostic prompts for any AI tool, from anywhere.

---

Repository URLs

Access	Git Clone URL	Web UI
Internal (office)	http://10.10.10.166:3002/gitadmin/ArchiTools.git	http://10.10.10.166:3002/gitadmin/ArchiTools
External (internet)	https://git.beletage.ro/gitadmin/ArchiTools.git	https://git.beletage.ro/gitadmin/ArchiTools

Raw File URLs (for AI tools that can fetch URLs)

Replace {GITEA} with whichever base works for you:

• Internal: http://10.10.10.166:3002
• External: https://git.beletage.ro

File	URL
CLAUDE.md	{GITEA}/gitadmin/ArchiTools/raw/branch/main/CLAUDE.md
ROADMAP.md	{GITEA}/gitadmin/ArchiTools/raw/branch/main/ROADMAP.md
SESSION-LOG.md	{GITEA}/gitadmin/ArchiTools/raw/branch/main/SESSION-LOG.md
SESSION-GUIDE.md	{GITEA}/gitadmin/ArchiTools/raw/branch/main/SESSION-GUIDE.md
QA-CHECKLIST.md	{GITEA}/gitadmin/ArchiTools/raw/branch/main/QA-CHECKLIST.md

Production app: http://10.10.10.166:3000

---

PROMPT 1: New Session (any device, any AI)

I'm working on ArchiTools, an internal web dashboard for an architecture office.

Repository: https://git.beletage.ro/gitadmin/ArchiTools.git (branch: main)

Before doing anything, read these 4 files from the repo:
- CLAUDE.md (project context, stack, architecture, conventions)
- ROADMAP.md (complete task list — tasks with ✅ are done, pick the next one without ✅)
- SESSION-LOG.md (what previous sessions did)
- SESSION-GUIDE.md (workflow rules)

Setup: clone the repo (or pull latest if already cloned), run npm install.

Then pick the next uncompleted task from ROADMAP.md (work top to bottom, skip ✅ tasks).

Rules:
- Run `npx next build` before every commit — zero errors required
- Push to main when done — Portainer auto-deploys to production
- Update ROADMAP.md: mark completed tasks with ✅ and the date
- Update SESSION-LOG.md: add an entry at the TOP describing what you did
- Commit and push these log updates too
- Notify me when a task is ready for my review
- Do NOT move to the next task until I approve the current one
- Code in English, UI text in Romanian

---

PROMPT 2: Resume Previous Work

I'm continuing work on ArchiTools.

Repository: https://git.beletage.ro/gitadmin/ArchiTools.git (branch: main)

Read these files from the repo:
- CLAUDE.md (project context)
- ROADMAP.md (find the next task without ✅)
- SESSION-LOG.md (what was done in previous sessions)

Pull latest, npm install, then continue with the next uncompleted task.

Same rules: build must pass, push when done, update ROADMAP.md (✅ + date)
and SESSION-LOG.md, notify me for review before moving to next task.

---

PROMPT 3: Specific Task

I'm working on ArchiTools.
Repository: https://git.beletage.ro/gitadmin/ArchiTools.git (branch: main)

Read CLAUDE.md and ROADMAP.md from the repo first.
Pull latest, npm install.

Work on task [NUMBER] ([TASK NAME]) from ROADMAP.md.

Implement it, run `npx next build` (must pass), push to main,
update ROADMAP.md (✅ + date) and SESSION-LOG.md, then notify me.

---

PROMPT 4: Bug Fix

I'm working on ArchiTools.
Repository: https://git.beletage.ro/gitadmin/ArchiTools.git (branch: main)

Read CLAUDE.md from the repo first. Pull latest.

Bug: [DESCRIBE THE BUG]

Fix it, run `npx next build`, push to main.
Don't change anything unrelated. Update SESSION-LOG.md.

---

PROMPT 4B: QA Bug Fix Session (post-Phase 3)

I'm working on ArchiTools.
Repository: https://git.beletage.ro/gitadmin/ArchiTools.git (branch: main)

Read these files from the repo:
- CLAUDE.md (project context, stack, architecture)
- QA-CHECKLIST.md (testing checklist — look for items marked with bugs)
- SESSION-LOG.md (previous sessions for context)

Pull latest, npm install.

I tested the app and found bugs. Here is my bug list:

[PASTE YOUR BUG LIST HERE]

For each bug:
1. Investigate root cause
2. Fix it
3. Run `npx next build` — must pass
4. Commit with descriptive message

After fixing all bugs:
- Push to main
- Update SESSION-LOG.md with bug fix details
- Notify me for re-testing

---

PROMPT 5: Code Review (no changes)

I'm working on ArchiTools.
Repository: https://git.beletage.ro/gitadmin/ArchiTools.git (branch: main)

Read CLAUDE.md from the repo. Pull latest.

Review the last 3 commits. Check for:
- TypeScript strict mode issues
- Missing null guards
- UI text that should be in Romanian
- Unused imports or dead code
- Security issues

Don't change anything, just report findings.

---

PROMPT 6: New Module from Scratch

I'm working on ArchiTools.
Repository: https://git.beletage.ro/gitadmin/ArchiTools.git (branch: main)

Read CLAUDE.md and ROADMAP.md from the repo first.
Pull latest, npm install.

Build [MODULE NAME] as described in task [NUMBER] of ROADMAP.md.

Use the module at src/modules/registratura/ as reference for the pattern:
  types.ts, config.ts, services/, hooks/, components/, index.ts

Also create: route page, update modules.ts, navigation.ts, flags.ts.

Run `npx next build`, push to main, update ROADMAP.md + SESSION-LOG.md, notify me.

---

Tool-Specific Notes

Claude Code (CLI)

Works natively. Clone/pull, read files, edit, build, push — all built in.

ChatGPT Codex

Give it the repo URL. It can clone via git, read files, and push. Use the external URL: https://git.beletage.ro/gitadmin/ArchiTools.git

VS Code + Copilot / Cursor / Windsurf

Clone the repo locally first, then open in the IDE. The AI agent reads files from disk.

git clone https://git.beletage.ro/gitadmin/ArchiTools.git
cd ArchiTools && npm install && code .

Google Antigravity

Give it the repo URL. It can clone and work autonomously. Use: https://git.beletage.ro/gitadmin/ArchiTools.git

Phone (ChatGPT app, Claude app)

Can't run code directly, but can read files via raw URLs and give guidance:

Read these URLs and help me plan the next task:
https://git.beletage.ro/gitadmin/ArchiTools/raw/branch/main/CLAUDE.md
https://git.beletage.ro/gitadmin/ArchiTools/raw/branch/main/ROADMAP.md
https://git.beletage.ro/gitadmin/ArchiTools/raw/branch/main/SESSION-LOG.md

---

Git Workflow

First time (any device)

git clone https://git.beletage.ro/gitadmin/ArchiTools.git
cd ArchiTools
npm install
npm run dev

Session start (pull latest)

git pull origin main
npm install

Session end (push)

npx next build
git add <specific-files>
git commit -m "feat(module): description

Co-Authored-By: <model-name>"
git push origin main

---

Files to Update After Every Session

1. ROADMAP.md — Mark done tasks

### 1.01 ✅ (2026-02-18) `[LIGHT]` Verify Email Signature Logo Files

2. SESSION-LOG.md — Add entry at the TOP

## Session — 2026-02-18 (Sonnet 4.6)

### Completed

- 1.01: Verified logo files
- 1.02: Added address toggle

### In Progress

- 1.03: Prompt templates — 4 of 10 done

### Blockers

- Need logo files from user

### Notes

- Build passes, commit abc1234

---

3. CLAUDE.md — Only if architecture changes

4. Commit + push all log updates before ending the session

---

Handoff Rules

1. Always pull before starting — another session may have pushed
2. Always push before ending — don't leave uncommitted work
3. Update SESSION-LOG.md — the next AI has zero memory
4. Mark ROADMAP.md — ✅ with date is the source of truth
5. Don't skip tasks — ordered by dependency
6. Ask user if blocked — don't guess on design decisions
7. One task at a time — implement, build, push, get approval, then next