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

```bash
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)

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

### Session start (pull latest)

```bash
git pull origin main
npm install
```

### Session end (push)

```bash
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

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

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

```markdown
## 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
