convez.ai
AgenteDesenvolvimento WebIntermediário
jeswr

Solid AI Coding

jeswr/solid-ai-coding

Guia estruturado para agentes de IA desenvolverem apps Solid production-ready

Ver no GitHub
InicialPluginScore · de 0 a 100

Guia opinado para agentes de IA (Claude Code, Codex, IBM Bob) construírem aplicações Solid com qualidade. Inclui regras específicas do Solid, padrões de biblioteca, stack de engenharia recomendada e integração com MCP server para documentação atualizada.

Instalação

$npx convez-ai jeswr/solid-ai-coding

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Configurar ambiente de desenvolvimento Solid com agentes IA
  • Padronizar stack de bibliotecas e padrões de engenharia
  • Automatizar setup de projeto com skills e MCP servers

Veredito

Recurso prático e bem estruturado para maximizar efetividade de agentes IA em projetos Solid. O setup automatizado e integração com context7 MCP reduzem atritos significativamente, embora exija familiaridade com Solid e agentes de código.

README

A tradução para o português deste README ainda está na fila.

solid-ai-coding

An opinionated guide that makes AI coding agents — Claude Code, OpenAI Codex, IBM Bob, and anything else that reads AGENTS.md — effective at building Solid applications.

The guide itself is AGENTS.md. It has two parts:

  1. Solid-specific rules — the recommended library stack, verified usage patterns for each library, how to pull accurate API docs via the context7 MCP server, and the superseded stacks agents must avoid.
  2. General engineering rules — application stack, TypeScript, testing, CI, accessibility, and process standards for shipping a high-quality app quickly.

Use it in your project

Order matters: scaffold your app first (create-next-app writes its own AGENTS.md and would overwrite the guide), then install the guide. The setup script merges if it finds an existing AGENTS.md; re-run it any time scaffolding clobbers the files. Copy two files into your repository root:

curl -fsSLO https://raw.githubusercontent.com/jeswr/solid-ai-coding/main/AGENTS.md
curl -fsSLO https://raw.githubusercontent.com/jeswr/solid-ai-coding/main/CLAUDE.md

AGENTS.md is the guide; CLAUDE.md is a one-line import (@AGENTS.md) for Claude Code, which does not read AGENTS.md natively.

Then wire up the context7 MCP server so your agent can fetch current library documentation instead of guessing APIs (a free API key from context7.com/dashboard raises rate limits but is optional):

Claude Code

CLAUDE.md is picked up automatically. Add context7:

claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcp

OpenAI Codex

AGENTS.md is picked up automatically. Add context7 to ~/.codex/config.toml:

[mcp_servers.context7]
url = "https://mcp.context7.com/mcp"

IBM Bob

Recommended: One-command setup (fully automated, cross-platform, parallelized):

curl -fsSL https://raw.githubusercontent.com/jeswr/solid-ai-coding/main/setup-bob.js | node

This single command:

  • ✅ Downloads guide files (AGENTS.md, CLAUDE.md)
  • ✅ Configures MCP server for library documentation
  • ✅ Installs the full recommended skill set in parallel (the Solid bundle + 14 engineering/design skills incl. TDD and UI quality)
  • ✅ Works on Windows, macOS, and Linux
  • ✅ Completes in ~1-2 minutes

After the script completes, reload VS Code: Cmd+Shift+P → Developer: Reload Window

Alternative: Conversational setup — just ask Bob:

I plan to develop a Solid application. Please help me set up my environment as prescribed in https://github.com/jeswr/solid-ai-coding/

Bob will run the setup script automatically. See BOB-SETUP-PROMPT.md for details.

The automated script is faster and more reliable, but if you need manual control:

# 1. Download guide files
curl -fsSLO https://raw.githubusercontent.com/jeswr/solid-ai-coding/main/AGENTS.md
curl -fsSLO https://raw.githubusercontent.com/jeswr/solid-ai-coding/main/CLAUDE.md

# 2. Configure MCP server
mkdir -p .bob
curl -fsSL https://raw.githubusercontent.com/jeswr/solid-ai-coding/main/config/mcp.json -o .bob/mcp.json

# 3. Install Solid skills
npx skills add jeswr/solid-ai-coding -a bob

# 4. Install engineering skills (run each in parallel for speed)
npx skills add obra/superpowers --skill test-driven-development -a bob &
npx skills add antfu/skills --skill vitest -a bob &
npx skills add currents-dev/playwright-best-practices-skill -a bob &
npx skills add anthropics/skills --skill webapp-testing -a bob &
npx skills add mcollina/skills --skill node -a bob &
npx skills add wshobson/agents --skill typescript-advanced-types -a bob &
npx skills add wshobson/agents --skill responsive-design -a bob &
npx skills add schalkneethling/webdev-agent-skills --skill semantic-html -a bob &
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a bob &
npx skills add emilkowalski/skill --skill emil-design-eng -a bob &
npx skills add wondelai/skills --skill web-typography -a bob &
npx skills add dembrandt/dembrandt-skills --skill color-mode-and-theme -a bob &
npx skills add addyosmani/agent-skills --skill code-review-and-quality -a bob &
npx skills add vercel-labs/skills --skill find-skills -a bob &
wait

# 5. Reload VS Code: Cmd+Shift+P → "Developer: Reload Window"

Other tools

Cursor, Zed, Windsurf, Gemini CLI, GitHub Copilot coding agent, Devin, and a growing list of other tools read AGENTS.md natively — copying the file is enough.

Solid skills

This repo bundles twelve Agent Skills under skills/ that go deeper than the guide — install them into your agent with:

npx skills add jeswr/solid-ai-coding -a claude-code -a codex -a bob
SkillCovers
solid-fetch-rdf@jeswr/fetch-rdf API reference (not in context7)
solid-object@solid/object API reference + ProfileAgent rendering reference class (not in context7)
solid-reactive-authentication@solid/reactive-authentication API reference + login/IdP-selection UX spec (not in context7)
solid-server-matrixDiagnosing CSS / ESS / NSS differences when an app works on one server and breaks on another
solid-type-indexReading, writing, and bootstrapping Type Index registries (with a compile-verified wrapper implementation)
solid-scale-and-shardingCollection data without hitting the walls — sharding, index resources, client-side querying
solid-notificationsLive-sync via the Solid Notifications Protocol and the legacy NSS channel
solid-offlineInstant-load reads: hydrate synchronously from a WebID-scoped durable cache, revalidate in the background (stale-while-revalidate)
solid-app-shellOptimistic, non-blocking pod mutations: update the UI immediately, persist async, save indicator, and the two revert-correctness traps
solid-test-infrastructureVerified test harness (Playwright + local CSS, account seeding, client-credentials fixtures) + the dev.mjs seeded dev environment
solid-client-idStatic Client Identifier Documents — verified template, Next.js hosting recipe, provider wiring (e2e-tested against CSS)
accessible-html-linksNative <a href> + WCAG link-purpose rules (derived from Solid-website review feedback)

The guide's Part 2 also names a default set of third-party engineering skills (vitest, Playwright, Node, TypeScript, semantic HTML, web design review, code review, and more) with verified one-line install commands — see AGENTS.md §Recommended skills.

Contributing

Issues and PRs welcome — especially corrections from people who hit an API drift between this guide and a released library version. Code examples in the guide are checked against the published packages at the versions stated (node_modules type declarations and behaviour), not against READMEs or git HEAD, both of which drift.

License

MIT

Ver o original no GitHub

Bom para

Relacionados