Aaradhya-Dev-Tamrakar/brainstorm

Skill de Gerenciamento de Projetos do Portfólio

REGRRA CRÍTICA: Sempre que o usuário solicitar adicionar, atualizar ou registrar um novo projeto ou ferramenta no site do portfólio (F:\AaradhyaDT\AaradhyaDT.github.io):

• NUNCA abra e fatie manualmente projects.html com regex ou substitua grandes blocos de string.
• NUNCA crie manualmente tags href raw do GitHub não criptografadas em projects.html.
• NUNCA codifique manualmente números de projeto (p-00x) ou contagens de pílulas de filtro.

Você DEVE invocar o mecanismo determinístico de integração de projetos: F:\AaradhyaDT\AaradhyaDT.github.io\scripts\add_project.py

---

1. Fluxo de Ingestão Rápida (Modo Manifest com Zero Tokens)

1. Formule um manifesto JSON de projeto limpo e compacto (na memória ou como arquivo temporário):

{
  "title": "Windows Pilot — Semantic UIA & MCP Desktop Automation Engine",
  "repo_url": "https://github.com/AaradhyaDT/windows-pilot",
  "category": ["apps", "hardware"],
  "status": "Sep 2026",
  "bullets": [
    "Motor de automação de desktop Windows de missão crítica para agentes de IA autônomos.",
    "Controle de Microsoft UI Automation (UIA) COM e Win32 independente de resolução.",
    "Servidor MCP nativo (winpilot-mcp) com consciência de área de trabalho virtual."
  ],
  "tags": ["Python 3.10+", "Win32 API", "MCP Server", "Windows 11"],
  "section": "personal",
  "tier": "vip"
}

2. Salve em um arquivo temporário (ex.: new_project.json) e execute com pré-visualização ou adição ao vivo:

Pré-visualização com Dry Run (Recomendado primeiro):

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

Aplicar ao Vivo:

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

---

2. Modo de Comando Único via CLI

Para adições rápidas diretamente por flags do terminal:

python scripts/add_project.py `
  --title "Nome da Ferramenta — Descrição do Subtítulo" `
  --repo "https://github.com/AaradhyaDT/minha-ferramenta" `
  --category apps aiml `
  --status "Em Andamento" `
  --bullets "Item 1 de arquitetura técnica chave." "Item 2 de benchmark ou métrica chave." `
  --tags "Python" "FastMCP" "Async"

---

3. O que o Mecanismo Executa Automaticamente

Em menos de 1 segundo, add_project.py realiza:

1. Atribuição de ID Contígua: Varre o DOM, encontra o maior inteiro atual (ex.: 34) e atribui p-035 e P — 035.
2. Criptografia sem Vazamento: Criptografa a URL do repositório com AES-256-GCM (PBKDF2) usando vip2026 ou master2026 e registra proj-<slug> em access.js.
3. Geração de Cartão: Gera marcação <details class="project-card reveal ..."> compatível e acessível com o link bloqueado data-payload-link-id="proj-<slug>".
4. Injeção na Seção DOM: Injeta o cartão em #section-personal (padrão) ou #section-projects.
5. Recontagem Exata de Filtros: Analisa todos os cartões no DOM e escreve automaticamente as contagens exatas em <span class="proj-filter-count"> para All, aiml, embedded, hardware e apps.
6. Integridade Pós-Adição: Executa automaticamente scripts/extract_index.py (atualiza índice de busca estático) e scripts/verify.py (garante a aprovação em todas as 26 categorias de verificação, incluindo release-shas e integridade de version).

---

4. Invariante de Integridade de SHA de Release e What's New

Sempre que versionar, incrementar versão ou adicionar releases a assets/js/data/releases.js:

• NUNCA use strings sha sintéticas ou placeholders (ex.: rel50, rel55, upg47, xtool20).
• SEMPRE garanta que cada sha seja um hash curto de commit Git válido e existente (correspondendo a ^[0-9a-f]{7,40}$) que resolva diretamente para https://github.com/AaradhyaDT/AaradhyaDT.github.io/commit/<sha>.
• O script scripts/site_automation.py resolve automaticamente git rev-parse --short HEAD para releases principais, e scripts/verify.py (Categoria 26: release-shas) impõe isso durante pre-commit e CI.

---

5. Finalizando a Implantação

Depois que todas as adições passarem pela verificação local:

.\sync.bat -m "feat(projects): registrar <nome-do-projeto> no showcase do portfólio"

(Executa extração de busca em passagem única, atualização do grafo AST, gate de verificação de 26 categorias, commit, push e sincronização com carimbo de bot).