bps-kit 1.0.19 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/cli.js +156 -28
- package/package.json +1 -1
- package/templates/VAULT_INDEX.md +5 -4
- package/templates/agents-template/agents/frontend-specialist.md +1 -1
- package/templates/agents-template/agents/site-builder.md +177 -0
- package/templates/agents-template/rules/GEMINI.md +5 -2
- package/templates/agents-template/workflows/build-site.md +122 -0
- package/templates/skills_extra/stitch-loop/README.md +54 -0
- package/templates/skills_extra/stitch-loop/SKILL.md +263 -0
- package/templates/skills_extra/stitch-loop/examples/SITE.md +73 -0
- package/templates/skills_extra/stitch-loop/examples/next-prompt.md +25 -0
- package/templates/skills_extra/stitch-loop/resources/baton-schema.md +61 -0
- package/templates/skills_extra/stitch-loop/resources/site-template.md +104 -0
- package/templates/skills_normal/design-md/README.md +34 -0
- package/templates/skills_normal/design-md/SKILL.md +172 -0
- package/templates/skills_normal/design-md/examples/DESIGN.md +154 -0
- package/templates/skills_normal/enhance-prompt/README.md +34 -0
- package/templates/skills_normal/enhance-prompt/SKILL.md +204 -0
- package/templates/skills_normal/enhance-prompt/references/KEYWORDS.md +114 -0
- package/templates/skills_normal/react-components/README.md +36 -0
- package/templates/skills_normal/react-components/SKILL.md +47 -0
- package/templates/skills_normal/react-components/examples/gold-standard-card.tsx +80 -0
- package/templates/skills_normal/react-components/package-lock.json +231 -0
- package/templates/skills_normal/react-components/package.json +16 -0
- package/templates/skills_normal/react-components/resources/architecture-checklist.md +15 -0
- package/templates/skills_normal/react-components/resources/component-template.tsx +37 -0
- package/templates/skills_normal/react-components/resources/stitch-api-reference.md +14 -0
- package/templates/skills_normal/react-components/resources/style-guide.json +27 -0
- package/templates/skills_normal/react-components/scripts/fetch-stitch.sh +30 -0
- package/templates/skills_normal/react-components/scripts/validate.js +70 -0
- package/templates/vault/remotion/README.md +105 -0
- package/templates/vault/remotion/examples/WalkthroughComposition.tsx +78 -0
- package/templates/vault/remotion/examples/screens.json +56 -0
- package/templates/vault/remotion/resources/composition-checklist.md +124 -0
- package/templates/vault/remotion/resources/screen-slide-template.tsx +123 -0
- package/templates/vault/remotion/scripts/download-stitch-asset.sh +38 -0
package/bin/cli.js
CHANGED
|
@@ -5,45 +5,165 @@ const path = require('path');
|
|
|
5
5
|
const chalk = require('chalk');
|
|
6
6
|
const ora = require('ora');
|
|
7
7
|
const { program } = require('commander');
|
|
8
|
+
const { execSync } = require('child_process');
|
|
9
|
+
|
|
10
|
+
const pkg = require('../package.json');
|
|
11
|
+
|
|
12
|
+
// Configuration
|
|
13
|
+
const TEMPLATES_DIR = path.join(__dirname, '..', 'templates');
|
|
14
|
+
const DEST_BASE = process.cwd();
|
|
15
|
+
const DEST_AGENTS = path.join(DEST_BASE, '.agents');
|
|
16
|
+
const LOCKFILE = path.join(DEST_BASE, '.bps-kit.json');
|
|
17
|
+
|
|
18
|
+
// ──────────────────────────────────────────────────────────────────────────────
|
|
19
|
+
// Custom Help
|
|
20
|
+
// ──────────────────────────────────────────────────────────────────────────────
|
|
21
|
+
function printHelp() {
|
|
22
|
+
console.log(`
|
|
23
|
+
${chalk.bold.cyan('🚀 BPS Kit')} ${chalk.dim(`v${pkg.version}`)} ${chalk.bold('— Antigravity IDE Brain Installer')}
|
|
24
|
+
|
|
25
|
+
${chalk.bold('USAGE:')}
|
|
26
|
+
${chalk.green('npx bps-kit')} ${chalk.dim('[profile] [options]')}
|
|
27
|
+
|
|
28
|
+
${chalk.bold('PROFILES:')}
|
|
29
|
+
${chalk.green('--basic')} Modo economia extrema (11 skills) — ideal para Copilot simples
|
|
30
|
+
${chalk.green('--normal')} Skills essenciais (42 skills) — ideal para Web/React/Next ${chalk.dim('[default]')}
|
|
31
|
+
${chalk.green('--extra')} Skills Premium (69 skills) — Python, QA, Cloud, Security
|
|
32
|
+
|
|
33
|
+
${chalk.bold('OPTIONS:')}
|
|
34
|
+
${chalk.green('--vscode')} Converte para o formato VS Code GitHub Copilot ${chalk.dim('(.github/)')}
|
|
35
|
+
${chalk.green('--update')} Re-instala o cérebro usando o perfil salvo neste projeto
|
|
36
|
+
${chalk.green('--upgrade')} Atualiza o pacote bps-kit para a versão mais recente no npm
|
|
37
|
+
${chalk.green('--help')} Exibe esta mensagem de ajuda
|
|
38
|
+
${chalk.green('--version')} Exibe a versão atual
|
|
39
|
+
|
|
40
|
+
${chalk.bold('EXAMPLES:')}
|
|
41
|
+
${chalk.dim('npx bps-kit --normal')}
|
|
42
|
+
${chalk.dim('npx bps-kit --extra --vscode')}
|
|
43
|
+
${chalk.dim('npx bps-kit --update')}
|
|
44
|
+
${chalk.dim('npx bps-kit --upgrade')}
|
|
45
|
+
|
|
46
|
+
${chalk.bold('TARGETS:')}
|
|
47
|
+
${chalk.cyan('Antigravity IDE')} ${chalk.dim('(primary)')} → ${chalk.dim('.agents/')}
|
|
48
|
+
${chalk.cyan('VS Code Copilot')} ${chalk.dim('(--vscode)')} → ${chalk.dim('.github/')} + ${chalk.dim('.copilot-skills/')}
|
|
49
|
+
`);
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
// ──────────────────────────────────────────────────────────────────────────────
|
|
53
|
+
// Upgrade — atualiza o próprio pacote npm
|
|
54
|
+
// ──────────────────────────────────────────────────────────────────────────────
|
|
55
|
+
async function runUpgrade() {
|
|
56
|
+
console.log(chalk.bold.cyan('\n🔄 BPS Kit — Upgrade\n'));
|
|
57
|
+
const spinner = ora('Verificando versão mais recente no npm...').start();
|
|
58
|
+
|
|
59
|
+
try {
|
|
60
|
+
const latest = execSync('npm show bps-kit version', { encoding: 'utf8' }).trim();
|
|
61
|
+
|
|
62
|
+
if (latest === pkg.version) {
|
|
63
|
+
spinner.succeed(chalk.green(`Você já está na versão mais recente: v${pkg.version}`));
|
|
64
|
+
return;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
spinner.text = `Atualizando bps-kit ${chalk.yellow(`v${pkg.version}`)} → ${chalk.green(`v${latest}`)}...`;
|
|
68
|
+
execSync('npm install -g bps-kit@latest', { stdio: 'inherit' });
|
|
69
|
+
spinner.succeed(chalk.green(`bps-kit atualizado para v${latest} com sucesso! 🎉`));
|
|
70
|
+
console.log(chalk.dim('\nPróxima execução: npx bps-kit --update (para re-instalar o cérebro com o novo pacote)\n'));
|
|
71
|
+
|
|
72
|
+
} catch (err) {
|
|
73
|
+
spinner.fail(chalk.red('Falha ao verificar ou instalar atualização.'));
|
|
74
|
+
console.error(chalk.dim(err.message));
|
|
75
|
+
process.exit(1);
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
// ──────────────────────────────────────────────────────────────────────────────
|
|
80
|
+
// Update — re-instala usando o perfil salvo em .bps-kit.json
|
|
81
|
+
// ──────────────────────────────────────────────────────────────────────────────
|
|
82
|
+
async function runUpdate() {
|
|
83
|
+
console.log(chalk.bold.cyan('\n♻️ BPS Kit — Update\n'));
|
|
84
|
+
|
|
85
|
+
if (!await fs.pathExists(LOCKFILE)) {
|
|
86
|
+
console.log(chalk.red('✖ Lockfile .bps-kit.json não encontrado neste diretório.'));
|
|
87
|
+
console.log(chalk.yellow(' Execute a instalação inicial primeiro:'));
|
|
88
|
+
console.log(chalk.dim(' npx bps-kit --normal (ou --basic / --extra)\n'));
|
|
89
|
+
process.exit(1);
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
const lock = await fs.readJson(LOCKFILE);
|
|
93
|
+
const mode = lock.mode || 'normal';
|
|
94
|
+
const wasVscode = lock.vscode || false;
|
|
95
|
+
|
|
96
|
+
console.log(chalk.white(`Perfil detectado : `) + chalk.greenBright(mode.toUpperCase()));
|
|
97
|
+
console.log(chalk.white(`VS Code mode : `) + chalk.greenBright(wasVscode ? 'sim' : 'não'));
|
|
98
|
+
console.log('');
|
|
99
|
+
|
|
100
|
+
// Reutilizar a lógica de instalação
|
|
101
|
+
await runInstaller({ basic: mode === 'basic', normal: mode === 'normal', extra: mode === 'extra', vscode: wasVscode });
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
// ──────────────────────────────────────────────────────────────────────────────
|
|
105
|
+
// Commander setup
|
|
106
|
+
// ──────────────────────────────────────────────────────────────────────────────
|
|
107
|
+
|
|
108
|
+
// Interceptar --help e ausência de flags ANTES do commander processar
|
|
109
|
+
const rawArgs = process.argv.slice(2);
|
|
110
|
+
if (rawArgs.length === 0 || rawArgs.includes('--help') || rawArgs.includes('-h')) {
|
|
111
|
+
printHelp();
|
|
112
|
+
process.exit(0);
|
|
113
|
+
}
|
|
8
114
|
|
|
9
115
|
program
|
|
10
|
-
.
|
|
11
|
-
.
|
|
116
|
+
.name('bps-kit')
|
|
117
|
+
.version(pkg.version, '-v, --version', 'Exibe a versão atual')
|
|
118
|
+
.description('BPS Kit — Antigravity IDE Brain Installer')
|
|
12
119
|
.option('-b, --basic', 'Modo economia extrema (11 skills apenas o core analítico, ideal para Copilot)')
|
|
13
|
-
.option('-n, --normal', 'Instala as skills essenciais (
|
|
14
|
-
.option('-e, --extra', 'Instala as skills avançadas Premium (
|
|
15
|
-
.option('--vscode', 'Converte a estrutura
|
|
120
|
+
.option('-n, --normal', 'Instala as skills essenciais (42 skills, ideal para Web/React/Next)')
|
|
121
|
+
.option('-e, --extra', 'Instala as skills avançadas Premium (69 skills, inclui Python, QA, Cloud e Sec)')
|
|
122
|
+
.option('--vscode', 'Converte a estrutura para o formato VS Code GitHub Copilot (.github/)')
|
|
123
|
+
.option('--update', 'Re-instala o cérebro usando o perfil salvo (.bps-kit.json)')
|
|
124
|
+
.option('--upgrade', 'Atualiza o pacote bps-kit para a versão mais recente no npm')
|
|
125
|
+
.helpOption(false)
|
|
16
126
|
.parse(process.argv);
|
|
17
127
|
|
|
18
128
|
const options = program.opts();
|
|
19
129
|
|
|
20
|
-
//
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
130
|
+
// Roteamento
|
|
131
|
+
if (options.upgrade) {
|
|
132
|
+
runUpgrade();
|
|
133
|
+
} else if (options.update) {
|
|
134
|
+
runUpdate();
|
|
135
|
+
} else {
|
|
136
|
+
(async () => {
|
|
137
|
+
// Determinar o mode (default normal se nao passar args)
|
|
138
|
+
let mode = 'normal';
|
|
139
|
+
if (options.basic) {
|
|
140
|
+
mode = 'basic';
|
|
141
|
+
} else if (options.extra) {
|
|
142
|
+
mode = 'extra';
|
|
143
|
+
}
|
|
144
|
+
await runInstaller({ ...options, _mode: mode });
|
|
145
|
+
})();
|
|
146
|
+
}
|
|
25
147
|
|
|
26
|
-
|
|
148
|
+
// ──────────────────────────────────────────────────────────────────────────────
|
|
149
|
+
// Installer principal
|
|
150
|
+
// ──────────────────────────────────────────────────────────────────────────────
|
|
151
|
+
async function runInstaller(opts = {}) {
|
|
27
152
|
console.log(chalk.bold.cyan('\n🚀 BPS Kit Setup Inicializado'));
|
|
28
153
|
console.log(chalk.dim('Instalando Cérebro de IA customizado para seu repositório...\n'));
|
|
29
154
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
if (
|
|
33
|
-
|
|
34
|
-
} else if (options.extra) {
|
|
35
|
-
mode = 'extra';
|
|
36
|
-
} else if (!options.normal && !options.extra && !options.basic) {
|
|
37
|
-
console.log(chalk.yellow('⚠️ Nenhum perfil explicitado (--basic, --normal ou --extra). Utilizando default: --normal\n'));
|
|
38
|
-
}
|
|
155
|
+
let mode = opts._mode || 'normal';
|
|
156
|
+
if (opts.basic) mode = 'basic';
|
|
157
|
+
else if (opts.extra) mode = 'extra';
|
|
158
|
+
else if (opts.normal) mode = 'normal';
|
|
39
159
|
|
|
40
160
|
const spinner = ora('Montando diretórios base...').start();
|
|
41
161
|
|
|
42
162
|
try {
|
|
43
|
-
if (
|
|
163
|
+
if (opts.vscode && await fs.pathExists(path.join(DEST_BASE, '.github'))) {
|
|
44
164
|
spinner.warn(chalk.yellow('Aviso: Pasta .github detectada. Os artefatos do Copilot serão sobrescritos se existirem.'));
|
|
45
165
|
spinner.start('Montando diretórios base...');
|
|
46
|
-
} else if (!
|
|
166
|
+
} else if (!opts.vscode && await fs.pathExists(DEST_AGENTS)) {
|
|
47
167
|
spinner.warn(chalk.yellow('Aviso: Pasta .agents já existe. O BPS Kit a sobrescreverá.'));
|
|
48
168
|
spinner.start('Montando diretórios base...');
|
|
49
169
|
}
|
|
@@ -101,32 +221,42 @@ async function runInstaller() {
|
|
|
101
221
|
}
|
|
102
222
|
|
|
103
223
|
// 5. Conversor para VS Code se solicitado
|
|
104
|
-
if (
|
|
224
|
+
if (opts.vscode) {
|
|
105
225
|
spinner.text = `Transformando arquitetura para padrão GitHub Copilot (VS Code)...`;
|
|
106
226
|
const { convertToVsCode } = require('./convert_to_vscode');
|
|
107
227
|
await convertToVsCode(DEST_AGENTS, DEST_BASE);
|
|
108
228
|
}
|
|
109
229
|
|
|
230
|
+
// 6. Salvar lockfile com perfil utilizado
|
|
231
|
+
await fs.writeJson(LOCKFILE, {
|
|
232
|
+
mode,
|
|
233
|
+
vscode: opts.vscode || false,
|
|
234
|
+
version: pkg.version,
|
|
235
|
+
installedAt: new Date().toISOString(),
|
|
236
|
+
}, { spaces: 2 });
|
|
237
|
+
|
|
110
238
|
spinner.succeed(chalk.green('Cérebro de IA instanciado com sucesso!'));
|
|
111
239
|
|
|
112
|
-
let finalCount = '
|
|
240
|
+
let finalCount = '42';
|
|
113
241
|
if (mode === 'basic') finalCount = '11';
|
|
114
|
-
if (mode === 'extra') finalCount = '
|
|
242
|
+
if (mode === 'extra') finalCount = '69';
|
|
115
243
|
|
|
116
244
|
console.log(chalk.cyan('\n============== [ RESUMO DA INSTALAÇÃO ] =============='));
|
|
117
245
|
console.log(chalk.white(`Perfil Carregado : `) + chalk.greenBright(mode.toUpperCase()));
|
|
118
246
|
console.log(chalk.white(`Skills Ativas : `) + chalk.greenBright(finalCount));
|
|
119
247
|
console.log(chalk.white(`Skills no Vault : `) + chalk.greenBright('1197'));
|
|
248
|
+
console.log(chalk.white(`Lockfile : `) + chalk.dim('.bps-kit.json'));
|
|
120
249
|
console.log(chalk.cyan('======================================================'));
|
|
121
250
|
|
|
122
251
|
console.log(chalk.yellow('\n💡 Next Steps:'));
|
|
123
|
-
if (
|
|
252
|
+
if (opts.vscode) {
|
|
124
253
|
console.log(chalk.white('1. O GitHub Copilot Agent já deve estar lendo o `.github/copilot-instructions.md`.'));
|
|
125
254
|
} else {
|
|
126
255
|
console.log(chalk.white('1. O sistema Antigravity já deve estar lendo o `.agents/rules/GEMINI.md`.'));
|
|
127
256
|
}
|
|
128
257
|
console.log(chalk.white('2. Para auto-calibrar a sua IA baseada nos arquivos deste repositório, basta pedir para ele:\n'));
|
|
129
258
|
console.log(chalk.dim(' "Rode a workflow setup-brain para otimizar minhas skills neste projeto"'));
|
|
259
|
+
console.log(chalk.dim('\n npx bps-kit --update (para re-instalar o cérebro após um upgrade)'));
|
|
130
260
|
console.log('\n🌟 Boa codificação estruturada!\n');
|
|
131
261
|
|
|
132
262
|
} catch (error) {
|
|
@@ -135,5 +265,3 @@ async function runInstaller() {
|
|
|
135
265
|
process.exit(1);
|
|
136
266
|
}
|
|
137
267
|
}
|
|
138
|
-
|
|
139
|
-
runInstaller();
|
package/package.json
CHANGED
package/templates/VAULT_INDEX.md
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
# 🗄️ Vault Index
|
|
2
2
|
|
|
3
3
|
> 1197 skills in `./.agents/vault/`.
|
|
4
|
+
> Active skills (not in vault): `design-md`, `enhance-prompt`, `react-components`, `stitch-loop`
|
|
4
5
|
> To use: `view_file ./.agents/vault/{skill-name}/SKILL.md`
|
|
5
6
|
|
|
6
|
-
## Web & Frontend (
|
|
7
|
-
3d-web-experience angular angular-best-practices angular-migration angular-state-management angular-ui-patterns animejs-animation antigravity-design-expert antigravity-workflows baseline-ui chrome-extension-developer cloudflare-workers-expert design-
|
|
7
|
+
## Web & Frontend (52)
|
|
8
|
+
3d-web-experience angular angular-best-practices angular-migration angular-state-management angular-ui-patterns animejs-animation antigravity-design-expert antigravity-workflows baseline-ui chrome-extension-developer cloudflare-workers-expert design-orchestration design-spells frontend-dev-guidelines frontend-mobile-development-component-scaffold frontend-mobile-security-xss-scan frontend-security-coder frontend-slides frontend-ui-dark-ts html-injection-testing nextjs-app-router-patterns radix-ui-design-system react-best-practices react-flow-architect react-flow-node-ts react-modernization react-native-architecture react-nextjs-development react-state-management react-ui-patterns spline-3d-integration tailwind-design-system threejs-animation threejs-fundamentals threejs-geometry threejs-interaction threejs-lighting threejs-loaders threejs-materials threejs-postprocessing threejs-shaders threejs-skills threejs-textures ui-skills ui-ux-pro-max ui-visual-validator web-artifacts-builder web-design-guidelines web-scraper web-security-testing webflow-automation
|
|
8
9
|
|
|
9
10
|
## Mobile (17)
|
|
10
11
|
android-jetpack-compose-expert android_ui_verification building-native-ui earllm-build expo-api-routes expo-cicd-workflows expo-deployment expo-dev-client expo-tailwind-setup expo-ui-jetpack-compose expo-ui-swift-ui flutter-expert ios-developer mobile-design mobile-developer mobile-security-coder swiftui-expert-skill
|
|
@@ -51,5 +52,5 @@ astropy biopython family-health-analyzer fda-food-safety-auditor fda-medtech-com
|
|
|
51
52
|
## Personas & Advisors (12)
|
|
52
53
|
andrej-karpathy bill-gates elon-musk geoffrey-hinton ilya-sutskever sam-altman steve-jobs warren-buffett yann-lecun yann-lecun-debate yann-lecun-filosofia yann-lecun-tecnico
|
|
53
54
|
|
|
54
|
-
## Other (
|
|
55
|
-
00-andruia-consultant 10-andruia-skill-smith 20-andruia-niche-intelligence SPDD accessibility-compliance-accessibility-audit address-github-comments advanced-evaluation advogado-criminal advogado-especialista agent-evaluation agent-framework-azure-ai-py agent-manager-skill agent-memory-mcp agent-memory-systems agent-orchestration-improve-agent agent-orchestration-multi-agent-optimize agent-orchestrator agent-tool-builder agentfolio agentic-actions-auditor agentmail agents-md agents-v2-py airflow-dag-patterns algolia-search algorithmic-art alpha-vantage amazon-alexa apify-actor-development apify-actorization apify-audience-analysis apify-brand-reputation-monitoring apify-competitor-intelligence apify-content-analytics apify-ecommerce apify-influencer-discovery apify-lead-generation apify-market-research apify-trend-analysis apify-ultimate-scraper appdeploy application-performance-performance-optimization architect-review architecture architecture-decision-records architecture-patterns arm-cortex-expert ask-questions-if-underspecified audio-transcriber audit-context-building auri-core auth-implementation-patterns automate-whatsapp avalonia-layout-zafiro avalonia-viewmodels-zafiro avalonia-zafiro-development avoid-ai-writing azd-deployment backtesting-frameworks bash-defensive-patterns bash-linux bash-pro bash-scripting beautiful-prose bevy-ecs-expert billing-automation binary-analysis-patterns blockrun blog-writing-guide browser-automation browser-extension-builder bug-hunter build busybox-on-windows carrier-relationship-management cc-skill-backend-patterns cc-skill-clickhouse-io cc-skill-coding-standards cc-skill-continuous-learning cc-skill-frontend-patterns cc-skill-project-guidelines-example cc-skill-security-review cc-skill-strategic-compact chat-widget cirq citation-management claimable-postgres clarity-gate claude-ally-health claude-code-expert claude-code-guide claude-d3js-skill claude-in-chrome-troubleshooting claude-monitor claude-scientific-skills claude-settings-audit claude-speed-reader claude-win11-speckit-update-skill code-refactoring-context-restore code-refactoring-refactor-clean code-refactoring-tech-debt code-review-ai-ai-review code-review-checklist code-review-excellence code-simplifier codebase-audit-pre-push codebase-cleanup-deps-audit codebase-cleanup-refactor-clean codebase-cleanup-tech-debt codex-review comfyui-gateway commit comprehensive-review-full-review comprehensive-review-pr-enhance computer-use-agents conductor-implement conductor-manage conductor-new-track conductor-revert conductor-setup conductor-status conductor-validator context7-auto-research conversation-memory copilot-sdk copy-editing core-components cqrs-implementation create-branch create-pr customs-trade-compliance daily daily-news-report data-engineer data-engineering-data-driven-feature data-engineering-data-pipeline data-quality-frameworks data-scientist data-structure-protocol data-visualization dbt-transformation-patterns ddd-context-mapping ddd-strategic-design ddd-tactical-patterns debug-buttercup debugger debugging-strategies debugging-toolkit-smart-debug deep-research dependency-management-deps-audit dependency-upgrade devcontainer-setup development distributed-debugging-debug-trace distributed-tracing docs docs-architect docx docx-official dwarf-expert dx-optimizer emblemai-crypto-wallet emergency-card employment-contract-templates energy-procurement enhance-prompt environment-setup-guide error-debugging-error-analysis error-debugging-error-trace error-debugging-multi-agent-review error-detective error-diagnostics-error-analysis error-diagnostics-error-trace error-diagnostics-smart-debug error-handling-patterns event-sourcing-architect event-store-design evolution exa-search fal-audio fal-generate fal-image-edit fal-platform fal-upscale fal-workflow favicon file-organizer file-uploads filesystem-context finishing-a-development-branch firebase firecrawl-scraper fix-review fixing-accessibility fixing-metadata fixing-motion-performance form-cro fp-async fp-backend fp-data-transforms fp-either-ref fp-errors fp-option-ref fp-pipe-ref fp-pragmatic fp-react fp-refactor fp-taskeither-ref fp-ts-errors fp-ts-pragmatic fp-ts-react fp-types-ref framework-migration-code-migrate framework-migration-deps-upgrade framework-migration-legacy-modernize full-stack-orchestration-full-stack-feature game-development gdpr-data-handling gh-review-requests git-advanced-workflows git-hooks-automation git-pr-workflows-git-workflow git-pr-workflows-onboard git-pr-workflows-pr-enhance github-actions-templates github-issue-creator github-workflow-automation go-concurrency-patterns go-playwright go-rod-master godot-4-migration godot-gdscript-patterns googlesheets-automation graphql graphql-architect great-tables grimoire hierarchical-agent-memory hig-components-content hig-components-controls hig-components-dialogs hig-components-layout hig-components-menus hig-components-search hig-components-status hig-components-system hig-foundations hig-inputs hig-patterns hig-platforms hig-project-context hig-technologies hosted-agents hosted-agents-v2-py hybrid-search-implementation i18n-localization iconsax-library image-studio imagen incident-responder incident-response-incident-response incident-response-smart-fix incident-runbook-templates infinite-gratitude integrate-whatsapp interactive-portfolio internal-comms-anthropic internal-comms-community inventory-demand-planning issues it-depends iterate-pr javascript-mastery javascript-typescript-typescript-scaffold junta-leiloeiros jupyter-workflow kaizen last30days legacy-modernizer leiloeiro-avaliacao leiloeiro-edital leiloeiro-ia leiloeiro-juridico leiloeiro-mercado leiloeiro-risco libreoffice literature-analysis local-legal-seo-audit logistics-exception-management loki-mode m365-agents-dotnet m365-agents-py m365-agents-ts machine-learning-ops-ml-pipeline magic-animator magic-ui-generator makepad-animation makepad-basics makepad-deployment makepad-dsl makepad-event-action makepad-font makepad-layout makepad-platform makepad-reference makepad-shaders makepad-skills makepad-splash makepad-widgets manifest matematico-tao matplotlib mcp-builder mcp-builder-ms memory-safety-patterns memory-systems mermaid-expert microsoft-azure-webjobs-extensions-authentication-events-dotnet minecraft-bukkit-pro modern-javascript-patterns molykit monorepo-architect monorepo-management monte-carlo-treasury monte-carlo-vulnerability-detection moodle-external-api-development mtls-configuration multi-advisor multi-agent-brainstorming multi-agent-patterns multi-cloud-architecture multi-platform-apps-multi-platform nanobanana-ppt-skills native-data-fetching nerdzao-elite nerdzao-elite-gemini-high network-101 network-engineer networkx new-rails-project notebooklm numpy nx-workspace-patterns observe-whatsapp obsidian-clipper-template-creator odoo-accounting-setup odoo-automated-tests odoo-backup-strategy odoo-docker-deployment odoo-ecommerce-configurator odoo-edi-connector odoo-hr-payroll-setup odoo-inventory-optimizer odoo-l10n-compliance odoo-manufacturing-advisor odoo-migration-helper odoo-module-developer odoo-orm-expert odoo-performance-tuner odoo-project-timesheet odoo-purchase-workflow odoo-qweb-templates odoo-rpc-api odoo-sales-crm-expert odoo-security-rules odoo-shopify-integration odoo-upgrade-advisor odoo-woocommerce-bridge odoo-xml-views-builder office-productivity onboarding-cro open-source-context openapi-spec-generation operational-guidelines os-scripting osint-evals oss-hunter paper-analysis parallel-agents payment-integration paypal-integration paywall-upgrade-cro pci-compliance pdf pdf-official performance-engineer performance-optimizer performance-testing-review-ai-review performance-testing-review-multi-agent-review personal-tool-builder plaid-fintech planning-with-files plotly podcast-generation polars polyfile posix-shell-pro postmortem-writing powershell-windows pptx pptx-official pr-writer product-design production-code-audit production-scheduling professional-proofreader project-development projection-patterns publish-and-summary pydantic-models-py pygraphistry pypict-skill python-development-python-scaffold python-packaging python-patterns python-performance-optimization python-security-auditor qiskit quality-nonconformance quant-analyst quantitative-analysis rails-upgrade receiving-code-review reference-builder remotion remotion-best-practices requesting-code-review research-engineer returns-reverse-logistics reverse-engineer risk-manager risk-metrics-calculation risk-modeling robius-app-architecture robius-event-action robius-matrix-integration robius-state-management robius-widget-patterns saas-mvp-launcher saga-orchestration sales-automator sast-configuration scientific-writing scikit-learn scipy screen-reader-testing screenshots scripts seaborn search-specialist senior-architect shader-programming-glsl sharp-edges shellcheck-configuration similarity-search-patterns skill-creator skill-creator-ms skill-developer skill-improver skill-installer skill-rails-upgrade skill-router skill-scanner skill-seekers skill-sentinel skill-writer spark-optimization spec-to-code-compliance speckit-updater speed sred-project-organizer sred-work-summary stability-ai static-analysis statsmodels stitch-loop stitch-ui-design stride-analysis-patterns subagent-driven-development superpowers-lab supply-chain-risk-auditor sympy systems-programming-rust-project tanstack-query-expert task-intelligence tavily-web testing-handbook-skills testing-qa theme-factory threat-mitigation-mapping tool-design track-management tutorial-engineer twilio-communications typescript-advanced-types typescript-expert umap uncle-bob-craft unity-developer unity-ecs-patterns unreal-engine-cpp-pro unsplash-integration upgrading-expo upstash-qstash using-git-worktrees using-neon using-superpowers uv-package-manager varlock varlock-claude-skill vercel-deploy-claimable vexor vexor-cli vibe-code-auditor videodb videodb-skills vizcom wcag-audit-patterns wordpress wordpress-plugin-development wordpress-theme-development wordpress-woocommerce-development workflow-automation workflow-orchestration-patterns workflow-patterns workflow-skill-design writing-plans writing-skills x-article-publisher-skill x-twitter-scraper xlsx xlsx-official zapier-make-patterns zod-validation-expert zustand-store-ts
|
|
55
|
+
## Other (533)
|
|
56
|
+
00-andruia-consultant 10-andruia-skill-smith 20-andruia-niche-intelligence SPDD accessibility-compliance-accessibility-audit address-github-comments advanced-evaluation advogado-criminal advogado-especialista agent-evaluation agent-framework-azure-ai-py agent-manager-skill agent-memory-mcp agent-memory-systems agent-orchestration-improve-agent agent-orchestration-multi-agent-optimize agent-orchestrator agent-tool-builder agentfolio agentic-actions-auditor agentmail agents-md agents-v2-py airflow-dag-patterns algolia-search algorithmic-art alpha-vantage amazon-alexa apify-actor-development apify-actorization apify-audience-analysis apify-brand-reputation-monitoring apify-competitor-intelligence apify-content-analytics apify-ecommerce apify-influencer-discovery apify-lead-generation apify-market-research apify-trend-analysis apify-ultimate-scraper appdeploy application-performance-performance-optimization architect-review architecture architecture-decision-records architecture-patterns arm-cortex-expert ask-questions-if-underspecified audio-transcriber audit-context-building auri-core auth-implementation-patterns automate-whatsapp avalonia-layout-zafiro avalonia-viewmodels-zafiro avalonia-zafiro-development avoid-ai-writing azd-deployment backtesting-frameworks bash-defensive-patterns bash-linux bash-pro bash-scripting beautiful-prose bevy-ecs-expert billing-automation binary-analysis-patterns blockrun blog-writing-guide browser-automation browser-extension-builder bug-hunter build busybox-on-windows carrier-relationship-management cc-skill-backend-patterns cc-skill-clickhouse-io cc-skill-coding-standards cc-skill-continuous-learning cc-skill-frontend-patterns cc-skill-project-guidelines-example cc-skill-security-review cc-skill-strategic-compact chat-widget cirq citation-management claimable-postgres clarity-gate claude-ally-health claude-code-expert claude-code-guide claude-d3js-skill claude-in-chrome-troubleshooting claude-monitor claude-scientific-skills claude-settings-audit claude-speed-reader claude-win11-speckit-update-skill code-refactoring-context-restore code-refactoring-refactor-clean code-refactoring-tech-debt code-review-ai-ai-review code-review-checklist code-review-excellence code-simplifier codebase-audit-pre-push codebase-cleanup-deps-audit codebase-cleanup-refactor-clean codebase-cleanup-tech-debt codex-review comfyui-gateway commit comprehensive-review-full-review comprehensive-review-pr-enhance computer-use-agents conductor-implement conductor-manage conductor-new-track conductor-revert conductor-setup conductor-status conductor-validator context7-auto-research conversation-memory copilot-sdk copy-editing core-components cqrs-implementation create-branch create-pr customs-trade-compliance daily daily-news-report data-engineer data-engineering-data-driven-feature data-engineering-data-pipeline data-quality-frameworks data-scientist data-structure-protocol data-visualization dbt-transformation-patterns ddd-context-mapping ddd-strategic-design ddd-tactical-patterns debug-buttercup debugger debugging-strategies debugging-toolkit-smart-debug deep-research dependency-management-deps-audit dependency-upgrade devcontainer-setup development distributed-debugging-debug-trace distributed-tracing docs docs-architect docx docx-official dwarf-expert dx-optimizer emblemai-crypto-wallet emergency-card employment-contract-templates energy-procurement environment-setup-guide error-debugging-error-analysis error-debugging-error-trace error-debugging-multi-agent-review error-detective error-diagnostics-error-analysis error-diagnostics-error-trace error-diagnostics-smart-debug error-handling-patterns event-sourcing-architect event-store-design evolution exa-search fal-audio fal-generate fal-image-edit fal-platform fal-upscale fal-workflow favicon file-organizer file-uploads filesystem-context finishing-a-development-branch firebase firecrawl-scraper fix-review fixing-accessibility fixing-metadata fixing-motion-performance form-cro fp-async fp-backend fp-data-transforms fp-either-ref fp-errors fp-option-ref fp-pipe-ref fp-pragmatic fp-react fp-refactor fp-taskeither-ref fp-ts-errors fp-ts-pragmatic fp-ts-react fp-types-ref framework-migration-code-migrate framework-migration-deps-upgrade framework-migration-legacy-modernize full-stack-orchestration-full-stack-feature game-development gdpr-data-handling gh-review-requests git-advanced-workflows git-hooks-automation git-pr-workflows-git-workflow git-pr-workflows-onboard git-pr-workflows-pr-enhance github-actions-templates github-issue-creator github-workflow-automation go-concurrency-patterns go-playwright go-rod-master godot-4-migration godot-gdscript-patterns googlesheets-automation graphql graphql-architect great-tables grimoire hierarchical-agent-memory hig-components-content hig-components-controls hig-components-dialogs hig-components-layout hig-components-menus hig-components-search hig-components-status hig-components-system hig-foundations hig-inputs hig-patterns hig-platforms hig-project-context hig-technologies hosted-agents hosted-agents-v2-py hybrid-search-implementation i18n-localization iconsax-library image-studio imagen incident-responder incident-response-incident-response incident-response-smart-fix incident-runbook-templates infinite-gratitude integrate-whatsapp interactive-portfolio internal-comms-anthropic internal-comms-community inventory-demand-planning issues it-depends iterate-pr javascript-mastery javascript-typescript-typescript-scaffold junta-leiloeiros jupyter-workflow kaizen last30days legacy-modernizer leiloeiro-avaliacao leiloeiro-edital leiloeiro-ia leiloeiro-juridico leiloeiro-mercado leiloeiro-risco libreoffice literature-analysis local-legal-seo-audit logistics-exception-management loki-mode m365-agents-dotnet m365-agents-py m365-agents-ts machine-learning-ops-ml-pipeline magic-animator magic-ui-generator makepad-animation makepad-basics makepad-deployment makepad-dsl makepad-event-action makepad-font makepad-layout makepad-platform makepad-reference makepad-shaders makepad-skills makepad-splash makepad-widgets manifest matematico-tao matplotlib mcp-builder mcp-builder-ms memory-safety-patterns memory-systems mermaid-expert microsoft-azure-webjobs-extensions-authentication-events-dotnet minecraft-bukkit-pro modern-javascript-patterns molykit monorepo-architect monorepo-management monte-carlo-treasury monte-carlo-vulnerability-detection moodle-external-api-development mtls-configuration multi-advisor multi-agent-brainstorming multi-agent-patterns multi-cloud-architecture multi-platform-apps-multi-platform nanobanana-ppt-skills native-data-fetching nerdzao-elite nerdzao-elite-gemini-high network-101 network-engineer networkx new-rails-project notebooklm numpy nx-workspace-patterns observe-whatsapp obsidian-clipper-template-creator odoo-accounting-setup odoo-automated-tests odoo-backup-strategy odoo-docker-deployment odoo-ecommerce-configurator odoo-edi-connector odoo-hr-payroll-setup odoo-inventory-optimizer odoo-l10n-compliance odoo-manufacturing-advisor odoo-migration-helper odoo-module-developer odoo-orm-expert odoo-performance-tuner odoo-project-timesheet odoo-purchase-workflow odoo-qweb-templates odoo-rpc-api odoo-sales-crm-expert odoo-security-rules odoo-shopify-integration odoo-upgrade-advisor odoo-woocommerce-bridge odoo-xml-views-builder office-productivity onboarding-cro open-source-context openapi-spec-generation operational-guidelines os-scripting osint-evals oss-hunter paper-analysis parallel-agents payment-integration paypal-integration paywall-upgrade-cro pci-compliance pdf pdf-official performance-engineer performance-optimizer performance-testing-review-ai-review performance-testing-review-multi-agent-review personal-tool-builder plaid-fintech planning-with-files plotly podcast-generation polars polyfile posix-shell-pro postmortem-writing powershell-windows pptx pptx-official pr-writer product-design production-code-audit production-scheduling professional-proofreader project-development projection-patterns publish-and-summary pydantic-models-py pygraphistry pypict-skill python-development-python-scaffold python-packaging python-patterns python-performance-optimization python-security-auditor qiskit quality-nonconformance quant-analyst quantitative-analysis rails-upgrade receiving-code-review reference-builder remotion remotion-best-practices requesting-code-review research-engineer returns-reverse-logistics reverse-engineer risk-manager risk-metrics-calculation risk-modeling robius-app-architecture robius-event-action robius-matrix-integration robius-state-management robius-widget-patterns saas-mvp-launcher saga-orchestration sales-automator sast-configuration scientific-writing scikit-learn scipy screen-reader-testing screenshots scripts seaborn search-specialist senior-architect shader-programming-glsl sharp-edges shellcheck-configuration similarity-search-patterns skill-creator skill-creator-ms skill-developer skill-improver skill-installer skill-rails-upgrade skill-router skill-scanner skill-seekers skill-sentinel skill-writer spark-optimization spec-to-code-compliance speckit-updater speed sred-project-organizer sred-work-summary stability-ai static-analysis statsmodels stitch-ui-design stride-analysis-patterns subagent-driven-development superpowers-lab supply-chain-risk-auditor sympy systems-programming-rust-project tanstack-query-expert task-intelligence tavily-web testing-handbook-skills testing-qa theme-factory threat-mitigation-mapping tool-design track-management tutorial-engineer twilio-communications typescript-advanced-types typescript-expert umap uncle-bob-craft unity-developer unity-ecs-patterns unreal-engine-cpp-pro unsplash-integration upgrading-expo upstash-qstash using-git-worktrees using-neon using-superpowers uv-package-manager varlock varlock-claude-skill vercel-deploy-claimable vexor vexor-cli vibe-code-auditor videodb videodb-skills vizcom wcag-audit-patterns wordpress wordpress-plugin-development wordpress-theme-development wordpress-woocommerce-development workflow-automation workflow-orchestration-patterns workflow-patterns workflow-skill-design writing-plans writing-skills x-article-publisher-skill x-twitter-scraper xlsx xlsx-official zapier-make-patterns zod-validation-expert zustand-store-ts
|
|
@@ -3,7 +3,7 @@ name: frontend-specialist
|
|
|
3
3
|
description: Senior Frontend Architect who builds maintainable React/Next.js systems with performance-first mindset. Use when working on UI components, styling, state management, responsive design, or frontend architecture. Triggers on keywords like component, react, vue, ui, ux, css, tailwind, responsive.
|
|
4
4
|
tools: Read, Grep, Glob, Bash, Edit, Write
|
|
5
5
|
model: inherit
|
|
6
|
-
skills: clean-code, nextjs-react-expert, web-design-guidelines, tailwind-patterns, frontend-design, lint-and-validate
|
|
6
|
+
skills: clean-code, nextjs-react-expert, web-design-guidelines, tailwind-patterns, frontend-design, lint-and-validate, design-md, enhance-prompt
|
|
7
7
|
---
|
|
8
8
|
|
|
9
9
|
# Senior Frontend Architect
|
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: site-builder
|
|
3
|
+
description: Senior Creative Technologist who builds cinematic, pixel-perfect landing pages with preset design systems, GSAP animations, and immersive scroll experiences. Triggers on keywords like landing page, site, website, cinematic, hero, parallax, build site, one-pager.
|
|
4
|
+
tools: Read, Grep, Glob, Bash, Edit, Write
|
|
5
|
+
model: inherit
|
|
6
|
+
skills: clean-code, scroll-experience, tailwind-patterns, react-patterns, frontend-design, design-md, enhance-prompt, react-components
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Senior Creative Technologist — Cinematic Site Builder
|
|
10
|
+
|
|
11
|
+
You are a world-class Senior Creative Technologist and Lead Frontend Engineer. You build cinematic, high-fidelity landing pages that are "1:1 Pixel Perfect". Every site you produce must feel like a digital instrument — every scroll intentional, every animation weighted and professional. Eradicate all generic AI patterns.
|
|
12
|
+
|
|
13
|
+
## 📑 Quick Navigation
|
|
14
|
+
|
|
15
|
+
- [Agent Flow](#agent-flow)
|
|
16
|
+
- [Aesthetic Presets](#aesthetic-presets)
|
|
17
|
+
- [Fixed Design System](#fixed-design-system)
|
|
18
|
+
- [Component Architecture](#component-architecture)
|
|
19
|
+
- [Technical Requirements](#technical-requirements)
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Agent Flow — MUST FOLLOW
|
|
24
|
+
|
|
25
|
+
When the user asks to build a site (or this agent is activated for a new project), ask **exactly these questions** in a single call, then build the complete site from the answers. Do not over-discuss. Build.
|
|
26
|
+
|
|
27
|
+
### Questions (all in one interaction)
|
|
28
|
+
|
|
29
|
+
1. **"What is the brand name and its purpose in one sentence?"** — Free text. Example: "Nura Health — precision longevity medicine driven by biological data."
|
|
30
|
+
2. **"Choose an aesthetic direction"** — Single selection from the presets below. Each preset provides a complete design system (palette, typography, image mood, identity label).
|
|
31
|
+
3. **"What are your 3 main value propositions?"** — Free text. Short phrases. They will become the Features section cards.
|
|
32
|
+
4. **"What should visitors do?"** — Free text. The primary CTA. Example: "Join the waitlist", "Book a consultation", "Start free trial".
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## Aesthetic Presets
|
|
37
|
+
|
|
38
|
+
Each preset defines: `palette`, `typography`, `identity` (the overall feel), and `imageMood` (Unsplash search keywords for hero/texture images).
|
|
39
|
+
|
|
40
|
+
### Preset A — "Organic Tech" (Boutique Clinic)
|
|
41
|
+
- **Identity:** A bridge between a biological research lab and a cutting-edge luxury magazine.
|
|
42
|
+
- **Palette:** Moss `#2E4036` (Primary), Clay `#CC5833` (Accent), Cream `#F2F0E9` (Background), Charcoal `#1A1A1A` (Text/Dark)
|
|
43
|
+
- **Typography:** Headings: "Plus Jakarta Sans" + "Outfit" (tight tracking). Drama: "Cormorant Garamond" Italic. Data: `"IBM Plex Mono"`.
|
|
44
|
+
- **Image Mood:** dark forest, organic textures, moss, ferns, laboratory glassware.
|
|
45
|
+
- **Hero phrase pattern:** "[Conceptual noun] is the" (Bold Sans) / "[Power word]." (Massive Serif Italic)
|
|
46
|
+
|
|
47
|
+
### Preset B — "Midnight Luxe" (Dark Editorial)
|
|
48
|
+
- **Identity:** A private members club meets a high-end watchmaker's atelier.
|
|
49
|
+
- **Palette:** Obsidian `#0D0D12` (Primary), Champagne `#C9A84C` (Accent), Ivory `#FAF8F5` (Background), Slate `#2A2A35` (Text/Dark)
|
|
50
|
+
- **Typography:** Headings: "Inter" (tight tracking). Drama: "Playfair Display" Italic. Data: `"JetBrains Mono"`.
|
|
51
|
+
- **Image Mood:** dark marble, gold accents, architectural shadows, luxury interiors.
|
|
52
|
+
- **Hero phrase pattern:** "[Aspirational noun] meets" (Bold Sans) / "[Precision word]." (Massive Serif Italic)
|
|
53
|
+
|
|
54
|
+
### Preset C — "Brutalist Signal" (Raw Precision)
|
|
55
|
+
- **Identity:** A control room for the future — no decoration, pure information density.
|
|
56
|
+
- **Palette:** Paper `#E8E4DD` (Primary), Signal Red `#E63B2E` (Accent), Off-white `#F5F3EE` (Background), Black `#111111` (Text/Dark)
|
|
57
|
+
- **Typography:** Headings: "Space Grotesk" (tight tracking). Drama: "DM Serif Display" Italic. Data: `"Space Mono"`.
|
|
58
|
+
- **Image Mood:** concrete, brutalist architecture, raw materials, industrial.
|
|
59
|
+
- **Hero phrase pattern:** "[Direct verb] the" (Bold Sans) / "[System noun]." (Massive Serif Italic)
|
|
60
|
+
|
|
61
|
+
### Preset D — "Vapor Clinic" (Neon Biotech)
|
|
62
|
+
- **Identity:** A genome sequencing lab inside a Tokyo nightclub.
|
|
63
|
+
- **Palette:** Deep Void `#0A0A14` (Primary), Plasma `#7B61FF` (Accent), Ghost `#F0EFF4` (Background), Graphite `#18181B` (Text/Dark)
|
|
64
|
+
- **Typography:** Headings: "Sora" (tight tracking). Drama: "Instrument Serif" Italic. Data: `"Fira Code"`.
|
|
65
|
+
- **Image Mood:** bioluminescence, dark water, neon reflections, microscopy.
|
|
66
|
+
- **Hero phrase pattern:** "[Tech noun] beyond" (Bold Sans) / "[Boundary word]." (Massive Serif Italic)
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## Fixed Design System (NEVER ALTER)
|
|
71
|
+
|
|
72
|
+
These rules apply to ALL presets. This is what makes the output premium.
|
|
73
|
+
|
|
74
|
+
### Visual Texture
|
|
75
|
+
- Implement a global CSS noise overlay using an inline SVG `<feTurbulence>` filter with **0.05 opacity** to eliminate flat digital gradients.
|
|
76
|
+
- Use a border system of `rounded-[2rem]` to `rounded-[3rem]` for all containers. No sharp corners anywhere.
|
|
77
|
+
|
|
78
|
+
### Micro-Interactions
|
|
79
|
+
- All buttons must have a **"magnetic" feel**: subtle `scale(1.03)` on hover with `cubic-bezier(0.25, 0.46, 0.45, 0.94)`.
|
|
80
|
+
- Buttons use `overflow-hidden` with a sliding `<span>` background layer for hover color transitions.
|
|
81
|
+
- Links and interactive elements get a `translateY(-1px)` lift on hover.
|
|
82
|
+
|
|
83
|
+
### Animation Lifecycle
|
|
84
|
+
- Use `gsap.context()` inside `useEffect` for ALL animations. Return `ctx.revert()` in cleanup.
|
|
85
|
+
- Default easing: `power3.out` for entrances, `power2.inOut` for morphs.
|
|
86
|
+
- Stagger value: `0.08` for text, `0.15` for cards/containers.
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## Component Architecture (NEVER ALTER STRUCTURE — only adapt content/colors)
|
|
91
|
+
|
|
92
|
+
### A. NAVBAR — "The Floating Island"
|
|
93
|
+
A `fixed`, pill-shaped container centered horizontally.
|
|
94
|
+
- **Morphing Logic:** Transparent with light text on top of hero. Transitions to `bg-[background]/60 backdrop-blur-xl` with primary-color text and a subtle `border` when scroll passes hero. Use `IntersectionObserver` or ScrollTrigger.
|
|
95
|
+
- Contains: Logo (brand name as text), 3-4 nav links, CTA button (accent color).
|
|
96
|
+
|
|
97
|
+
### B. HERO SECTION — "The Opening Scene"
|
|
98
|
+
- `100dvh` height. Full-bleed background image (fetched from Unsplash matching the preset's `imageMood`) with a strong **primary-to-black gradient overlay** (`bg-gradient-to-t`).
|
|
99
|
+
- **Layout:** Content pushed to the **bottom-left third** using flex + padding.
|
|
100
|
+
- **Typography:** Large scale contrast following the preset's Hero phrase pattern. First part using the bold sans heading font. Second part using the massive italic serif drama font (3-5x size difference).
|
|
101
|
+
- **Animation:** GSAP staggered `fade-up` animation (y: 40 → 0, opacity: 0 → 1) for all text parts and CTA.
|
|
102
|
+
- CTA button below main title, using accent color.
|
|
103
|
+
|
|
104
|
+
### C. FEATURES — "Interactive Functional Artifacts"
|
|
105
|
+
Three cards derived from the user's 3 value propositions. They must look like **functional software micro-UIs**, not static marketing cards. Each card gets one of these interaction patterns:
|
|
106
|
+
|
|
107
|
+
**Card 1 — "Diagnostic Shuffler":** 3 overlapping cards that cycle vertically using `array.unshift(array.pop())` logic every 3 seconds with a spring bounce transition (`cubic-bezier(0.34, 1.56, 0.64, 1)`). Labels derived from user's first value prop (generate 3 sub-labels).
|
|
108
|
+
|
|
109
|
+
**Card 2 — "Telemetry Typewriter":** A monospace live text feed that types messages character-by-character related to user's second value prop, with a blinking accent-color cursor. Include a "Live Feed" label with a pulsing dot.
|
|
110
|
+
|
|
111
|
+
**Card 3 — "Cursor Protocol Scheduler":** A weekly grid (S M T W T F S) where an animated SVG cursor enters, moves to a day cell, clicks (visual press with `scale(0.95)`), activates the day (accent color highlight), then moves to a "Save" button before fading out. Labels from user's third value prop.
|
|
112
|
+
|
|
113
|
+
All cards: `bg-[background]` surface, subtle border, `rounded-[2rem]`, drop shadow. Each card has a title (sans bold) and a brief description.
|
|
114
|
+
|
|
115
|
+
### D. PHILOSOPHY — "The Manifesto"
|
|
116
|
+
- Full-width section using the **dark color** as background.
|
|
117
|
+
- An organic texture image with parallax effect (Unsplash, `imageMood` keywords) with low opacity behind text.
|
|
118
|
+
- **Typography:** Two contrasting statements. Pattern:
|
|
119
|
+
- "Most [industry] focuses on: [common approach]." — neutral, smaller.
|
|
120
|
+
- "We focus on: [differentiated approach]." — massive, drama serif italic font, keyword in accent color.
|
|
121
|
+
- **Animation:** GSAP `SplitText`-style reveal (fade-up word-by-word or line-by-line) triggered by ScrollTrigger.
|
|
122
|
+
|
|
123
|
+
### E. PROTOCOL — "Sticky Stacking Archive"
|
|
124
|
+
3 full-screen cards that stack on scroll.
|
|
125
|
+
- **Stacking Interaction:** Using GSAP ScrollTrigger with `pin: true`. As a new card scrolls into view, the card underneath scales to `0.9`, gets `20px` blur and `0.5` opacity.
|
|
126
|
+
- **Each card gets a unique canvas/SVG animation:**
|
|
127
|
+
1. A slowly spinning geometric pattern (double helix, concentric circles, or gears).
|
|
128
|
+
2. A horizontal scanning laser line moving over a dot/cell grid.
|
|
129
|
+
3. A pulsing waveform (EKG-style SVG path animation using `stroke-dashoffset`).
|
|
130
|
+
- Card content: Step number (monospace), title (heading font), 2-line description. Derive from user's brand purpose.
|
|
131
|
+
|
|
132
|
+
### F. MEMBERSHIP / PRICING
|
|
133
|
+
- Pricing grid with three tiers. Card names: "Essential", "Performance", "Enterprise" (adjust to match brand).
|
|
134
|
+
- **Middle card stands out:** Primary-color background with accent-color CTA button. Slightly larger scale or accented border (`ring`).
|
|
135
|
+
- If pricing doesn't apply, convert to a "Get Started" section with a single large CTA.
|
|
136
|
+
|
|
137
|
+
### G. FOOTER
|
|
138
|
+
- Deep dark-color background, `rounded-t-[4rem]`.
|
|
139
|
+
- Grid layout: Brand name + tagline, navigation columns, legal links.
|
|
140
|
+
- **"System Operational" status indicator** with a pulsing green dot and a monospace label.
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
## Technical Requirements (NEVER ALTER)
|
|
145
|
+
|
|
146
|
+
- **Stack:** React 19, Tailwind CSS v3.4.17, GSAP 3 (with ScrollTrigger plugin), Lucide React for icons.
|
|
147
|
+
- **Fonts:** Load via Google Fonts `<link>` tags in `index.html` based on selected preset.
|
|
148
|
+
- **Images:** Use real Unsplash URLs. Choose images matching the preset's `imageMood`. Never use placeholder URLs or images.
|
|
149
|
+
- **File structure:** Single `App.jsx` file with components defined in-file (or split into `components/` if >600 lines). Single `index.css` for Tailwind properties + noise overlay + custom utilities.
|
|
150
|
+
- **No placeholders.** Every card, every label, every animation must be fully implemented and functional.
|
|
151
|
+
- **Responsiveness:** Mobile-first. Stack cards vertically on mobile. Reduce hero font sizes on mobile. Collapse navbar to minimal version.
|
|
152
|
+
|
|
153
|
+
---
|
|
154
|
+
|
|
155
|
+
## Build Sequence
|
|
156
|
+
|
|
157
|
+
After receiving answers to the 4 questions:
|
|
158
|
+
|
|
159
|
+
1. Map selected preset to its complete design tokens (palette, fonts, image mood, identity).
|
|
160
|
+
2. Generate Hero copy using brand name + purpose + preset's hero phrase pattern.
|
|
161
|
+
3. Map the 3 value propositions to the 3 Features card patterns (Shuffler, Typewriter, Scheduler).
|
|
162
|
+
4. Generate Philosophy contrast statements from brand purpose.
|
|
163
|
+
5. Generate Protocol steps from brand process/methodology.
|
|
164
|
+
6. Scaffold: `npm create vite@latest`, install deps, write all files.
|
|
165
|
+
7. Ensure all animations are wired, all interactions work, all images load.
|
|
166
|
+
|
|
167
|
+
**Execution Directive:** "Don't build a site; build a digital instrument. Every scroll must be intentional, every animation must have weight and professionalism. Eradicate all generic AI patterns."
|
|
168
|
+
|
|
169
|
+
---
|
|
170
|
+
|
|
171
|
+
## Stitch Integration (Optional)
|
|
172
|
+
|
|
173
|
+
If the user's workspace has the Stitch MCP Server available:
|
|
174
|
+
|
|
175
|
+
1. **After building the site:** Use `design-md` skill to extract the design system into a `DESIGN.md` file for future consistency.
|
|
176
|
+
2. **For additional pages:** Use `enhance-prompt` skill to polish prompts before generating with Stitch.
|
|
177
|
+
3. **For component conversion:** Use `react-components` skill to convert Stitch-generated HTML into modular React components that match the site's design tokens.
|
|
@@ -67,7 +67,7 @@ Agent activated → Check frontmatter "skills:" → Read SKILL.md (INDEX) → Re
|
|
|
67
67
|
## 🧠 Skill Auto-Routing System (v8.0.0 — Vault Edition)
|
|
68
68
|
|
|
69
69
|
### Architecture
|
|
70
|
-
- **Active skills** (~
|
|
70
|
+
- **Active skills** (~69): in `./.agents/skills/` — explicitly read the SKILL.md file via file tools before using
|
|
71
71
|
- **Vault skills** (~1200+): in `./.agents/vault/` — discoverable via index
|
|
72
72
|
|
|
73
73
|
### Core Rule — Skills First
|
|
@@ -84,6 +84,8 @@ After invoking any skill, explicitly say: '📖 Using skill: [skill-name]' befor
|
|
|
84
84
|
| Intent | Skills to Use |
|
|
85
85
|
|--------|---------------|
|
|
86
86
|
| **New site/app** | brainstorming → plan-writing → frontend-design. SaaS: + senior-fullstack + micro-saas-launcher |
|
|
87
|
+
| **Landing page / site** | site-builder + scroll-experience + enhance-prompt. Workflow: build-site |
|
|
88
|
+
| **Stitch design** | design-md + enhance-prompt + react-components. Loop: stitch-loop (Extra) |
|
|
87
89
|
| **UI/component** | frontend-design + react-patterns + tailwind-patterns. Animated: + scroll-experience |
|
|
88
90
|
| **Auth/login** | Ask user: Clerk → clerk-auth / Supabase → nextjs-supabase-auth |
|
|
89
91
|
| **Database/ORM** | database-design + prisma-expert |
|
|
@@ -168,6 +170,7 @@ Before coding, answer: (1) Goal of agent/skill? (2) Principles to apply? (3) How
|
|
|
168
170
|
|---|---|---|
|
|
169
171
|
| **MOBILE** | `mobile-developer` | mobile-design |
|
|
170
172
|
| **WEB** | `frontend-specialist` | frontend-design |
|
|
173
|
+
| **LANDING PAGE** | `site-builder` | scroll-experience, enhance-prompt, design-md |
|
|
171
174
|
| **BACKEND** | `backend-specialist` | api-patterns, database-design |
|
|
172
175
|
|
|
173
176
|
> 🔴 Mobile + frontend-specialist = WRONG. Mobile = mobile-developer ONLY.
|
|
@@ -214,6 +217,6 @@ Priority: Security → Lint → Schema → Tests → UX → SEO → Lighthouse/E
|
|
|
214
217
|
|
|
215
218
|
## 📁 QUICK REFERENCE
|
|
216
219
|
|
|
217
|
-
- **Masters**: `orchestrator`, `project-planner`, `security-auditor`, `backend-specialist`, `frontend-specialist`, `mobile-developer`, `debugger`
|
|
220
|
+
- **Masters**: `orchestrator`, `project-planner`, `security-auditor`, `backend-specialist`, `frontend-specialist`, `site-builder`, `mobile-developer`, `debugger`
|
|
218
221
|
- **Key Skills**: `clean-code`, `brainstorming`, `app-builder`, `frontend-design`, `mobile-design`, `plan-writing`, `behavioral-modes`
|
|
219
222
|
- **Verify**: `.agent/scripts/verify_all.py`, `.agent/scripts/checklist.py`
|