AI Assistant
3abf0d189c
Registratura improvements: - Thread Explorer: new 'Fire conversatie' tab with timeline view, search, stats, gap tracking (la noi/la institutie), export to text report - Interactive I/O toggle: replaced direction dropdown with visual blue/orange button group (Intrat/Iesit with icons) - Doc type UX: alphabetical sort + immediate selection after adding custom type - AC Validity Tracker: full Autorizatie de Construire lifecycle workflow (12mo validity, execution phases, extension request, required docs checklist, monthly reminders, abandonment/expiry tracking) Password Vault rework (renamed to 'Parole Uzuale' v0.3.0): - New categories: WiFi, Portale Primarii, Avize Online, PIN Semnatura, Software, Hardware (replaced server/database/api) - Category icons (lucide-react) throughout list and form - WiFi QR code dialog with connection string copy - Context-aware form (PIN vs password label, hide email for WiFi/PIN, hide URL for WiFi, hide generator for PIN) - Dynamic stat cards showing top 3 categories by count - Removed encryption banner - Updated i18n, flags, config
305 lines
8.3 KiB
Markdown
305 lines
8.3 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` |
|
|
| 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
|