docs(using-lt-cli): document experimental --next flag (nest-base)

[pascal-klesse]

Summary

Documents the new experimental --next flag added to the lt CLI in lenneTech/cli#80.

The flag swaps the API template from nest-server-starter (MongoDB) to nest-base (Bun + Prisma 7 + Postgres + Better-Auth) and is intended for greenfield prototyping only.

Changes

plugins/lt-dev/skills/using-lt-cli/:

• SKILL.md:
  • new gotcha entry warning that --next projects are incompatible with lt server module/object/addProp/test/permissions,
  • --next added to lt fullstack init synopsis + parameter table,
  • --next added to lt server create synopsis,
  • "Created structure" + "Post-creation" updated to reflect the bun-based install path.
• examples.md: new "Experimental: --next (nest-base)" section with a standalone-API example, a fullstack example, and explicit limitations. Following sections renumbered.
• reference.md: detailed reference block for --next covering effects, limitations, and post-creation install commands.

Why this matters for future skill activations

Without these notes, the using-lt-cli skill would happily route a user from lt fullstack init --next to generating-nest-servers for follow-up lt server module work — which fails because nest-base has a different layout (Prisma instead of Mongoose, no src/server/modules/). The new gotcha + the limitations in examples/reference make that boundary explicit.

Test plan

• Frontmatter validator hook passes (edits split to keep --- out of old/new strings).
• All --next references match the cli implementation: forces apiMode = Rest, frameworkMode = npm, skips workspace install in fullstack mode.
• Companion cli PR (feat: experimental --next flag for nest-base template cli#80) merged.

Related

• cli PR: feat: experimental --next flag for nest-base template cli#80
• nest-base repo: https://github.com/lenneTech/nest-base

🤖 Generated with Claude Code