README

SkillsORM — Skills Pack para desenvolvimento Delphi/FPC com IA

Ciclo completo SSOT: da escrita ao laudo, unificando a robustez do VCL (Windows) com a versatilidade do FMX (Windows/Linux/macOS). Ecossistema baseado em VS Code e Cursor com SSOT propagado por 24 scripts PS1/Python.

Apresentação completa interativa: .cursor/ApresentationSkillsORM.html.

Pré-requisitos

Sistema operacional

• Windows 10 / 11 (recomendado). Os scripts bootstrap-*.ps1 criam symlinks entre .cursor/ (SSOT) e os espelhos .claude/, .vscode/, .continue/, .opencode/ — exigem uma das opções abaixo:
  • Sessão PowerShell elevada como Administrador, ou
  • Modo Programador ativado em Configurações → Privacidade e Segurança → Para desenvolvedores.
• Linux/macOS: suporte parcial via equivalentes Python (bootstrap_*.py). Symlinks funcionam nativamente sem privilégios elevados.

Ferramentas obrigatórias (Windows)

Atenção: as três ferramentas (PowerShell, Python e VS Code/Cursor com extensão Claude) são pré-requisitos no Windows. Sem qualquer uma delas o pack não funciona integralmente — Python é necessário porque scripts essenciais como pack_index_db.py, validate_pack.py e sync_cursor_pack.py não têm equivalente PS1.

IDEs e assistentes de IA suportados

Os espelhos são gerados automaticamente — basta abrir o repositório em qualquer das ferramentas abaixo:

• Cursor (SSOT primário — .cursor/) — Claude integrado nativamente
• VS Code + extensão Claude Code ou Claude Code CLI (.claude/)
• Continue (.continue/) — opcional
• OpenCode TUI/CLI (.opencode/ + opencode.json) — opcional

Toolchain Delphi/FPC (apenas para usar este pack em projetos reais)

Este repositório por si só é um pack de skills, não exige Delphi instalado. Para aplicar o pack em um projeto Delphi/FPC, você precisará:

Os caminhos são configuráveis via parâmetros do bootstrap-build-config.ps1 ou via .workspace/context.json.

Instalação rápida

1) Clonar o repositório

git clone https://github.com/cslsolucoes/SkillsORM.git
cd SkillsORM

2) Validar/criar os espelhos (FASE 1 do autostart)

powershell -ExecutionPolicy Bypass -File ".cursor/scripts/bootstrap-mirror-symlinks.ps1" -ValidateOnly

Se reportar problemas e você estiver em sessão elevada ou com Modo Programador, rode sem -ValidateOnly:

powershell -ExecutionPolicy Bypass -File ".cursor/scripts/bootstrap-mirror-symlinks.ps1"

3) Materializar arquivos paramétricos de raiz (FASE 2-A — Skills Project)

powershell -ExecutionPolicy Bypass -File ".cursor/scripts/bootstrap-skills-project.ps1" -ValidateOnly

Cria/atualiza CLAUDE.md, LICENSE, privacy-policy.md, README.md, .workspace/context.json a partir dos templates em .cursor/Templates/skills-project-bootstrap/ — idempotente, com backup automático em .cursor/Backup/skills-project/<timestamp>/ quando o template tiver versão maior.

4) Abrir no editor

Abrir a pasta no Cursor / Claude Code / VS Code. As skills, agents, rules e commands são reconhecidos automaticamente via os espelhos.

O Ciclo de Vida (7 commands de Workflow)

Cada command delega a um agente especializado. A skill developer-delphi-coding-standards está sempre ativa durante todas as fases.

/new-project → /spec → /write → /tdd → /doc → /review → /audit
   bootstrap   especificar  escrever  testar  documentar  revisar  auditar

Outros 7 commands de Execution: /autostart, /iniciar, /consolidar, /syncdb, /validate-docs, /sync-cursor-pack, /migration-plan.

Cenários típicos

Projeto legado: /audit → /spec → /review → /write (refactor guiado). Nova feature: /write → tester auto-invocado → /review (validação SOLID). Projeto novo: /new-project (P1..P9 interativo) → /spec (arquitetura upfront) → /write + /tdd iterativo.

Famílias de skills (213 ativas)

Os 36 agentes (5 grupos)

• Delphi Workflow (4): Auditor · Spec-Writer · Writer · Tester
• Delphi ORM Domain (11): delphi-orchestrator · modules-orchestrator · views-orchestrator · connections-expert · database-expert · exceptions-expert · loggers-expert · orm-architect · parameters-expert · poolconnections-expert · views-expert
• Vue · Web (5): vuejs-orchestrator · vuejs-core-expert · vuejs-routing-state · web-quality-expert · web-runtime-build
• Documentação (12): doc-orchestrator · architecture · class-scanner · class-writer · class-indexer · migration · review · roadmap · rules · cursor-rules-integration · superseded-definition · migration-conflict-resolution
• Plugin/Skill Dev (4): agent-creator · plugin-validator · skill-reviewer · (outros utilitários)

Implementação técnica — .cursor/ (SSOT)

Estrutura de pastas

.cursor/                      ??? Fonte can??nica (SSOT)
????????? skills/                   ??? 213 skills ativas (.md + frontmatter + exemplos)
????????? agents/                   ??? 36 agentes (.md)
????????? commands/                 ??? 14 slash-commands (.md)
????????? rules/                    ??? 12 rules (.mdc) com alwaysApply / globs / template
????????? scripts/                  ??? 24 scripts (10 PS1 + 14 Python)
????????? Templates/                ??? templates de scaffold (build-config, form-units, skills-project-bootstrap)
????????? ApresentationSkillsORM.html  ??? apresenta????o interativa do pack

.claude/  .vscode/  .continue/  .opencode/   ??? espelhos via symlinks ??? .cursor/
.workspace/                                  ??? estado por clone (context.json, index.db)

24 Scripts de bootstrap e infraestrutura

Bootstrap (8): bootstrap-mirror-symlinks (PS1+Python), bootstrap-autostart-mirrors (PS1+Python), bootstrap-build-config.ps1, bootstrap-form-unit.ps1, bootstrap-skills-project.ps1, Bootstrap-Reset.ps1, bootstrap_reset.py.

Sync e propagação (3): sync-cursor-pack (PS1+Python), scaffold-modules-backend.ps1.

Validação (3): validate_pack.py (1548 checks · 0 CRITICAL), validate_consolidated.py, validate-skills-consistency.py.

Indexação FTS5 (2): pack_index_db.py, database_session_manager.py (3 bases SQLite: pack/workspace/docs).

Geração e transformação (5): gen_pack_inventory.py, gen_project_index.py, gen_fileversion.py, gen_audit_badge.py, transform-headers-backend.ps1, transform-headers-adorm.ps1.

Utilitários (3): decompile-chm (PS1+Python), apply_mit_to_skills.py.

12 Rules

Áreas protegidas (plan mode obrigatório)

Antes de criar, mover, renomear, fundir ou eliminar arquivos em qualquer das áreas abaixo, é obrigatório apresentar um plano completo e aguardar aprovação explícita do usuário — mesmo que ele diga "execute" ou "faça":

• Documentation/ (recursivo)
• .cursor/skills/ (recursivo)
• .cursor/Templates/ (recursivo)
• .cursor/agents/ (recursivo)
• .cursor/rules/ (recursivo)

Detalhes em CLAUDE.md §"Áreas protegidas".

Documentação

• CLAUDE.md — instruções top-level para Claude Code
• .cursor/ApresentationSkillsORM.html — apresentação visual interativa
• .cursor/README.md — hub do pack
• .cursor/Templates/skills-project-bootstrap/README.md — templates de bootstrap deste projeto
• privacy-policy.md — política de privacidade
• LICENSE — MIT

Suporte e contato

• Empresa: CSL Tech Solutions
• Autor: Claiton de Souza Linhares
• GitHub: https://github.com/cslsolucoes

Licença

MIT — Copyright (c) 2026 CSL Tech Solutions.

Changelog (este arquivo)

• 1.3.0 (26/04/2026): E14 — Workspace Mirror Structure: rule artifact-placement-policy bumpada V1.1.0 → V1.2.0 com nova Regra 4-A — Estrutura espelhada (.workspace/ adota mesmo conjunto de subpastas de .cursor/); manifesto rules V1.6.4 → V1.6.5; categoria Plans adicionada à tabela de nomenclatura.
• 1.2.0 (26/04/2026): Manifesto bumped V1.24.0 → V1.25.0 (E13 — Documentation Quality Gates: 5 skills da família documentation-* bumpadas in-place com workflow obrigatório de 5 fases, parâmetros opcionais para subpastas/modos/portal, cruzamento deps↔imports stack-aware, decisões obrigatórias em Documentation/Decisions/, threshold de agregação dura).
• 1.1.0 (25/04/2026): Manifesto V1.24.0 (E12 — Indy Completion: HTTP/Email enriquecidos, +2 skills indy-ftp/indy-tcp).
• 1.0.0 (anterior): Versão inicial do README do repositório SkillsORM.