Skip to content

Viniciustda/OiTenta / .agents/skills/config-project-fullstack

config-project-fullstack

Unverified

Deterministically create a new Turbo monorepo from zero in the current directory with an apps/frontend Next.js app on port 3000 and an apps/backend NestJS app on port 4000, including CORS, @nestjs/config, .env.example and .env files, optional workspace package namespace rewriting, and a guard against rerunning inside an already-created workspace.

Config Project Fullstack

Use the script at scripts/create-project.js instead of replaying the scaffold steps manually.

Workflow

  1. Read references/script-contract.md if the request is about flags, safety guarantees, or namespace behavior.
  2. Run:
node .agents/skills/config-project-fullstack/scripts/create-project.js [--namespace @scope] [--force-clean]
  1. Always run the script from the folder that should become the project root. The final project must be created in the current directory, not in a sibling or nested destination folder.
  2. Prefer --namespace @scope when the user wants all workspace packages renamed to the same npm scope.
  3. Prefer --force-clean only when the current directory already contains a workspace created by this skill and the user clearly wants that generated structure recreated from zero.
  4. After the script finishes, verify the resulting workspace paths in the current directory and report what was created.

Behavior

  • Create the Turbo repo with npm.
  • Use the current directory as the final workspace destination.
  • Refuse to run again in a directory that already contains the generated fullstack workspace unless --force-clean is explicitly supplied.
  • Preserve pre-existing files and directories in the current directory when they do not conflict with generated project paths.
  • Remove the default apps/* created by Turbo.
  • Create apps/frontend with create-next-app.
  • Ensure Nest CLI exists, create apps/backend, install @nestjs/config, and patch the backend bootstrap files.
  • Create .env.example and .env for frontend and backend.
  • Reinstall workspace dependencies at the root to refresh the lockfile after scaffolding and namespace updates.
  • Rewrite package names and local package references when --namespace is provided.

Constraints

  • Keep the workflow deterministic and do not change the scaffold order unless the script itself is being updated.
  • Do not create the final project in another folder. The final workspace must land in the current directory only.
  • Refuse conflicting project paths in the current directory unless --force-clean is explicitly supplied.
  • Do not move, delete, or rewrite unrelated non-conflicting files or directories that already exist in the current directory.
  • Do not create extra documentation files beyond the skill resources already present.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 318kUpdated Claude CodeCodexUnverifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 196kUpdated Claude CodeCodexVerifiedInstall