Aaradhya-Dev-Tamrakar/brainstorm

Portfolio-Projekt-Manager Skill

KRITISCHE REGEL: Wenn der Benutzer darum bittet, ein neues Projekt oder Tool zur Portfolio-Website (F:\AaradhyaDT\AaradhyaDT.github.io) hinzuzufügen, zu aktualisieren oder zu registrieren:

• NIEMALS projects.html manuell öffnen und mit Regex oder durch Ersetzen großer Textblöcke bearbeiten.
• NIEMALS unverschlüsselte rohe GitHub href-Tags in projects.html manuell erstellen.
• NIEMALS Projektnummern (p-00x) oder Filter-Pillen-Anzahl manuell festlegen oder raten.

Du MUSST die deterministische Engine zur Projektaufnahme verwenden: F:\AaradhyaDT\AaradhyaDT.github.io\scripts\add_project.py

---

1. Schnelle Erfassung (Zero-Token-Manifest-Modus)

1. Erstelle ein sauberes, kompaktes JSON-Projektmanifest (entweder im Speicher oder als temporäre Datei):

{
  "title": "Windows Pilot — Semantic UIA & MCP Desktop Automation Engine",
  "repo_url": "https://github.com/AaradhyaDT/windows-pilot",
  "category": ["apps", "hardware"],
  "status": "Sep 2026",
  "bullets": [
    "Mission-critical Windows desktop automation engine for autonomous AI coding agents.",
    "Resolution-independent Microsoft UI Automation (UIA) COM & Win32 control.",
    "Native MCP server (winpilot-mcp) with virtual desktop awareness."
  ],
  "tags": ["Python 3.10+", "Win32 API", "MCP Server", "Windows 11"],
  "section": "personal",
  "tier": "vip"
}

2. Speichere es in einer temporären Datei (z. B. new_project.json) und führe es mit Vorschau oder Live-Hinzufügung aus:

Vorschau mit Dry Run (Empfohlen zuerst):

python scripts/add_project.py --from-json new_project.json --dry-run

Live anwenden:

python scripts/add_project.py --from-json new_project.json

---

2. CLI-Einzelbefehl-Modus

Für schnelle Hinzufügungen direkt über Terminal-Flags:

python scripts/add_project.py `
  --title "Tool Name — Subtitle Description" `
  --repo "https://github.com/AaradhyaDT/my-tool" `
  --category apps aiml `
  --status "In Progress" `
  --bullets "Key technical architecture item 1." "Key benchmark or metric item 2." `
  --tags "Python" "FastMCP" "Async"

---

3. Was die Engine automatisch ausführt

In weniger als 1 Sekunde führt add_project.py Folgendes aus:

1. Lückenlose ID-Vergabe: Scannt das DOM, findet die aktuelle maximale Ganzzahl (z. B. 34) und vergibt p-035 und P — 035.
2. Null-Leck-Verschlüsselung: Verschlüsselt die Repository-URL mit AES-256-GCM (PBKDF2) unter Verwendung von vip2026 oder master2026 und registriert proj-<slug> in access.js.
3. Kartengenerierung: Erzeugt konformes, barrierefreies <details class="project-card reveal ...">-Markup mit dem gesperrten Link data-payload-link-id="proj-<slug>".
4. DOM-Abschnittsinjektion: Fügt die Karte in #section-personal (Standard) oder #section-projects ein.
5. Exakte Filter-Neuzählung: Analysiert alle Karten im DOM und schreibt automatisch die genauen Zählwerte in <span class="proj-filter-count"> für All, aiml, embedded, hardware und apps.
6. Integritätsprüfung nach der Hinzufügung: Führt automatisch scripts/extract_index.py (aktualisiert den statischen Suchindex) und scripts/verify.py aus (stellt sicher, dass alle 26 Prüfkategorien bestanden werden, einschließlich release-shas und version-Integrität).

---

4. Release-SHA- und What's-New-Integritätsinvariante

Bei Versionsverwaltung, Bumping oder Hinzufügen von Releases zu assets/js/data/releases.js:

• NIEMALS synthetische oder Platzhalter-sha-Zeichenfolgen verwenden (z. B. rel50, rel55, upg47, xtool20).
• IMMER sicherstellen, dass jeder sha ein gültiger, existierender Git-Commit-Kurzhash ist (der ^[0-9a-f]{7,40}$ entspricht) und direkt zu https://github.com/AaradhyaDT/AaradhyaDT.github.io/commit/<sha> aufgelöst werden kann.
• scripts/site_automation.py löst automatisch git rev-parse --short HEAD für Haupt-Releases auf, und scripts/verify.py (Kategorie 26: release-shas) erzwingt dies beim Pre-Commit und in CI.

---

5. Abschluss der Bereitstellung

Sobald alle Hinzufügungen die lokale Verifikation bestehen:

.\sync.bat -m "feat(projects): register <project-name> in portfolio showcase"

(Führt Single-Pass-Suchextraktion, AST-Graphenaktualisierung, 26-Kategorien-Verifikationsgate, Commit, Push und Bot-Stamp-Synchronisation durch).