linx8 0.0.4

Linx 8 Builder

Linx 8 Builder provides a framework for building .NET backend applications with Claude Code. It includes project conventions, a scaffolding script, and a strict spec-first / BDD workflow baked into CLAUDE.md so Claude Code follows the same process on every change.

What's in the box

• CLAUDE.md — project instructions that Claude Code reads automatically. It defines the specification → Red → Green → Refactor → commit workflow, service layout conventions, and general coding guidelines.
• .claude/commands/create.md — the /create slash-command that scaffolds a fresh ASP.NET Core solution on first use.
• .claude/scripts/ — helper scripts invoked by Claude Code.

The repo deliberately contains no .NET code yet — Claude Code generates it on demand.

Requirements

• git
• .NET SDK 10.0
• Claude Code

Recommended tooling

• Visual Studio Code with the following extensions:
  • Claude Code for VS Code
  • C# Dev Kit
  • Cucumber (Gherkin) Full Support

Getting started

1. Install the linx8 .NET tool:

   dotnet tool install linx8 --global
   

2. Change to an empty folder where you would like to start your new project and invoke the linx8 tool:

   linx8
   

3. Open the folder in Visual Studio Code / Claude Code. Claude Code will pick up CLAUDE.md automatically.

4. Run /create <project-name> <company-name> in Claude Code to scaffold the initial ASP.NET Core solution.

5. Build features the BDD way. For every new feature or bug fix, ask Claude Code to implement it. It will:

   • Update the OpenAPI spec in the docs folder first (for REST API changes) and ask you to approve it.
   • Write a failing Gherkin scenario (and step definitions), then ask you to approve the tests.
   • Implement the minimum production code to make them pass.
   • Refactor, then ask you to confirm manual testing before committing.

   The exact sequence — including the stop-and-confirm gates — is specified in CLAUDE.md. No need to memorise it; Claude Code follows it for you.

Running the application

Once the application has been scaffolded using the /create slash-command, it can be run by either executing the Debug: Start Debugging command in Visual Studio Code (default key binding F5) or by running dotnet run <project-name> in the command line.

To run the tests, run dotnet test from the command line.

Sample prompts

Below are a few examples of prompts for achieving specific tasks while developing.

Add a service

Add a REST service host.

Claude will ask for a name for the service and generate and confirm the initial OpenAPI spec before writing tests and implementing the service.

Databases

Database setup

Database creation and versioning setup:

Have the app create a database called MyApp on the configured connection string if it doesn't yet exist. Install a mechanism whereby the application will apply update scripts as necessary to get the database schema to the current version.

Database MCP integration

Once a database has been created in the development environment, an MCP integration can be added so that Claude can easily connect to the database. This can be useful for adding sample data for manual testing.

Add an MCP integration for connecting to the database using the connection string in the app settings. The MCP server must be able to both read and write to the database.

Note: After adding an MCP integration, Claude Code needs to be restarted before it can use it. If you're working in Visual Studio Code, the Claude Code extension can be restarted by opening the Command Palette (Ctrl+Shift+P) and running the Developer: Restart Extension Host command.

Once an MCP integration has been added, the database can easily be populated with sample data using a prompt such as:

Add some users to the "user" table.