Aaradhya-Dev-Tamrakar/brainstorm

포트폴리오 프로젝트 관리자 스킬

핵심 규칙: 사용자가 포트폴리오 웹사이트(F:\AaradhyaDT\AaradhyaDT.github.io)에 새 프로젝트나 도구를 추가, 업데이트 또는 등록하도록 요청할 때마다:

• 절대 수동으로 projects.html을 열고 정규식으로 큰 문자열 블록을 슬라이싱하지 마십시오.
• 절대 projects.html에 암호화되지 않은 원시 GitHub href 태그를 수동으로 생성하지 마십시오.
• 절대 프로젝트 번호(p-00x) 또는 필터 필 개수를 하드코딩하거나 추측하지 마십시오.

반드시 결정론적 프로젝트 온보딩 엔진을 호출해야 합니다: F:\AaradhyaDT\AaradhyaDT.github.io\scripts\add_project.py

---

1. 빠른 수집 워크플로우(토큰 제로 매니페스트 모드)

1. 깔끔하고 간결한 프로젝트 JSON 매니페스트를 구성합니다(메모리 내 또는 임시 파일로):

{
  "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. 임시 파일(예: new_project.json)에 저장하고 미리 보기 또는 실시간 추가로 실행합니다:

Dry Run을 통한 미리 보기(먼저 권장):

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

실시간 적용:

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

---

2. CLI 단일 명령 모드

터미널 플래그를 통해 직접 빠르게 추가하려면:

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. 엔진이 자동으로 실행하는 작업

1초 이내에 add_project.py는 다음을 수행합니다:

1. 연속 ID 할당: DOM을 스캔하여 현재 최대 정수(예: 34)를 찾고 p-035 및 P — 035를 할당합니다.
2. 제로 누출 암호화: vip2026 또는 master2026을 사용하여 AES-256-GCM(PBKDF2)으로 저장소 URL을 암호화하고 access.js에 proj-<slug>를 등록합니다.
3. 카드 생성: 잠긴 링크 data-payload-link-id="proj-<slug>"와 함께 규정을 준수하는 접근 가능한 <details class="project-card reveal ..."> 마크업을 생성합니다.
4. DOM 섹션 주입: 카드를 #section-personal(기본값) 또는 #section-projects에 주입합니다.
5. 정확한 필터 재계산: DOM의 모든 카드를 구문 분석하고 All, aiml, embedded, hardware 및 apps에 대한 정확한 개수를 <span class="proj-filter-count">에 자동으로 씁니다.
6. 추가 후 무결성 검사: scripts/extract_index.py(정적 검색 인덱스 업데이트) 및 scripts/verify.py(release-shas 및 version 무결성을 포함한 26/26 검사 카테고리 통과 보장)를 자동으로 실행합니다.

---

4. 릴리스 SHA 및 새로운 기능 무결성 불변 조건

assets/js/data/releases.js에 버전 관리, 범프 또는 릴리스를 추가할 때마다:

• 절대 가짜 또는 자리 표시자 sha 문자열(예: rel50, rel55, upg47, xtool20)을 사용하지 마십시오.
• 항상 모든 sha가 https://github.com/AaradhyaDT/AaradhyaDT.github.io/commit/<sha>로 직접 확인되는 유효하고 존재하는 Git 커밋 짧은 해시(^[0-9a-f]{7,40}$ 정규식 일치)인지 확인하십시오.
• scripts/site_automation.py는 주요 릴리스의 경우 자동으로 git rev-parse --short HEAD를 확인하고, scripts/verify.py(카테고리 26: release-shas)는 커밋 전 및 CI 중에 이를 강제합니다.

---

5. 배포 마무리

모든 추가 사항이 로컬 검증을 통과하면:

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

(단일 패스 검색 추출, AST 그래프 업데이트, 26개 카테고리 검증 게이트, 커밋, 푸시 및 봇 스탬프 동기화를 실행합니다).