11 KiB
11 KiB
phase, plan, type, wave, depends_on, files_modified, autonomous, requirements, must_haves
| phase | plan | type | wave | depends_on | files_modified | autonomous | requirements | must_haves | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 01-architecture-foundation | 01 | execute | 1 |
|
true |
|
|
Purpose: Establish the architectural skeleton that all subsequent phases build on. Phase 1's concept is "solution structure and project boundaries" (per CODE-02). No feature code -- just the verified scaffold. Output: A buildable solution with three projects, shared references, and aligned port configuration.
<execution_context> @/home/ys/family-repo/AgenticCode/.claude/get-shit-done/workflows/execute-plan.md @/home/ys/family-repo/AgenticCode/.claude/get-shit-done/templates/summary.md </execution_context>
@.planning/PROJECT.md @.planning/ROADMAP.md @.planning/STATE.md @.planning/phases/01-architecture-foundation/01-CONTEXT.md @.planning/phases/01-architecture-foundation/01-RESEARCH.md Task 1: Create solution and three projects with references ChatAgent.sln, src/ChatAgent.Client/ChatAgent.Client.csproj, src/ChatAgent.Api/ChatAgent.Api.csproj, src/ChatAgent.Shared/ChatAgent.Shared.csproj .planning/phases/01-architecture-foundation/01-RESEARCH.md (Standard Stack and Installation sections), .planning/phases/01-architecture-foundation/01-CONTEXT.md (D-01 through D-03 decisions), CLAUDE.md Run the following commands from the repo root (`/home/ys/family-repo/AgenticCode`). Per D-01, D-02, D-03:1. Create the solution file at repo root:
```
dotnet new sln -n ChatAgent
```
2. Create the three projects targeting net9.0:
```
dotnet new blazorwasm -n ChatAgent.Client --framework net9.0 -o src/ChatAgent.Client
dotnet new webapi -n ChatAgent.Api --framework net9.0 --use-controllers -o src/ChatAgent.Api
dotnet new classlib -n ChatAgent.Shared --framework net9.0 -o src/ChatAgent.Shared
```
3. Add all three projects to the solution:
```
dotnet sln ChatAgent.sln add src/ChatAgent.Client/ChatAgent.Client.csproj
dotnet sln ChatAgent.sln add src/ChatAgent.Api/ChatAgent.Api.csproj
dotnet sln ChatAgent.sln add src/ChatAgent.Shared/ChatAgent.Shared.csproj
```
4. Add Shared reference to both Client and Api:
```
dotnet add src/ChatAgent.Client/ChatAgent.Client.csproj reference src/ChatAgent.Shared/ChatAgent.Shared.csproj
dotnet add src/ChatAgent.Api/ChatAgent.Api.csproj reference src/ChatAgent.Shared/ChatAgent.Shared.csproj
```
5. Delete the template-generated placeholder files that are not needed:
- `src/ChatAgent.Shared/Class1.cs` (will be replaced by Models/ directory in Plan 02)
- `src/ChatAgent.Api/Controllers/WeatherForecastController.cs` (template default, replaced by HealthController in Plan 02)
- `src/ChatAgent.Api/WeatherForecast.cs` (template default model)
6. Create a `.gitignore` at repo root if one does not already exist. Include standard .NET ignores:
```
bin/
obj/
*.user
*.suo
.vs/
.idea/
*.swp
**/wwwroot/_framework/
```
7. Run `dotnet build ChatAgent.sln` to verify the scaffold compiles.
1. Edit `src/ChatAgent.Client/Properties/launchSettings.json`:
- Set the HTTPS URL to `https://localhost:5200`
- Set the HTTP URL to `http://localhost:5100`
- Apply to both the profile used by `dotnet run` and any IIS Express profile
- Keep the `"inspectUri"` setting if present (needed for Blazor WASM debugging)
2. Edit `src/ChatAgent.Api/Properties/launchSettings.json`:
- Set the HTTPS URL to `https://localhost:7100`
- Set the HTTP URL to `http://localhost:7000`
- Remove the `"launchBrowser": true` setting if present (API has no browser UI)
3. Create `src/ChatAgent.Client/wwwroot/appsettings.json` with the API base URL:
```json
{
"ApiBaseUrl": "https://localhost:7100"
}
```
This file is PUBLIC (served to the browser). Never put secrets here.
4. Verify `src/ChatAgent.Api/appsettings.json` exists (template-generated). Remove any Swagger/OpenAPI configuration if present (not needed for this project). Ensure it has a clean structure:
```json
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
},
"AllowedHosts": "*"
}
```
5. Ensure `src/ChatAgent.Api/appsettings.Development.json` exists with dev logging:
```json
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
}
}
```
6. Run `dotnet build ChatAgent.sln` again to confirm nothing broke.
<success_criteria>
- Three-project solution builds from
dotnet build ChatAgent.slnwith zero errors - Projects are in
src/subdirectories per D-02 - Solution file is at repo root per D-03
- Shared library is referenced by both Client and Api
- Ports are predictable and aligned (Client: 5200, API: 7100)
- Template boilerplate (WeatherForecast) is removed </success_criteria>