501de5161e
All prompts now use repo URL instead of local paths. Works from any device: Mac, PC, phone, any AI tool. Two access points: internal (10.10.10.166:3002) and external (git.beletage.ro). Added tool-specific notes for Claude Code, ChatGPT Codex, Copilot, Cursor, Antigravity, phone. Raw file URLs for AI tools that can fetch web content. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
255 lines
7.0 KiB
Markdown
255 lines
7.0 KiB
Markdown
# 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` |
|
|
|
|
**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 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
|