4cf6c04a3e
Analyze Claude Code session history to build behavioral profiles across 8 dimensions (communication, decisions, debugging, UX, vendor choices, frustrations, learning style, explanation depth). Profiles generate USER-PROFILE.md, dev-preferences command, and CLAUDE.md profile section. New modules: - profile-pipeline.cjs: session scanning, message extraction, sampling - profile-output.cjs: profile rendering, questionnaire, artifact generation New files: - agents/gsd-user-profiler.md: profiler agent (8-dimension scoring) - commands/gsd/profile-user.md: user-facing command - workflows/profile-user.md: orchestration workflow - templates/: user-profile, dev-preferences, claude-md templates - references/user-profiling.md: detection heuristics reference 8 new CLI commands: scan-sessions, extract-messages, profile-sample, write-profile, profile-questionnaire, generate-dev-preferences, generate-claude-profile, generate-claude-md Co-authored-by: TÂCHES <afromanguy@me.com>
2.7 KiB
2.7 KiB
CLAUDE.md Template
Template for project-root CLAUDE.md — auto-generated by gsd-tools generate-claude-md.
Contains 5 marker-bounded sections. Each section is independently updatable.
The generate-claude-md subcommand manages 4 sections (project, stack, conventions, architecture).
The profile section is managed exclusively by generate-claude-profile.
Section Templates
Project Section
<!-- GSD:project-start source:PROJECT.md -->
## Project
{{project_content}}
<!-- GSD:project-end -->
Fallback text:
Project not yet initialized. Run /gsd:new-project to set up.
Stack Section
<!-- GSD:stack-start source:STACK.md -->
## Technology Stack
{{stack_content}}
<!-- GSD:stack-end -->
Fallback text:
Technology stack not yet documented. Will populate after codebase mapping or first phase.
Conventions Section
<!-- GSD:conventions-start source:CONVENTIONS.md -->
## Conventions
{{conventions_content}}
<!-- GSD:conventions-end -->
Fallback text:
Conventions not yet established. Will populate as patterns emerge during development.
Architecture Section
<!-- GSD:architecture-start source:ARCHITECTURE.md -->
## Architecture
{{architecture_content}}
<!-- GSD:architecture-end -->
Fallback text:
Architecture not yet mapped. Follow existing patterns found in the codebase.
Profile Section (Placeholder Only)
<!-- GSD:profile-start -->
## Developer Profile
> Profile not yet configured. Run `/gsd:profile-user` to generate your developer profile.
> This section is managed by `generate-claude-profile` — do not edit manually.
<!-- GSD:profile-end -->
Note: This section is NOT managed by generate-claude-md. It is managed exclusively
by generate-claude-profile. The placeholder above is only used when creating a new
CLAUDE.md file and no profile section exists yet.
Section Ordering
- Project — Identity and purpose (what this project is)
- Stack — Technology choices (what tools are used)
- Conventions — Code patterns and rules (how code is written)
- Architecture — System structure (how components fit together)
- Profile — Developer behavioral preferences (how to interact)
Marker Format
- Start:
<!-- GSD:{name}-start source:{file} --> - End:
<!-- GSD:{name}-end --> - Source attribute enables targeted updates when source files change
- Partial match on start marker (without closing
-->) for detection
Fallback Behavior
When a source file is missing, fallback text provides Claude-actionable guidance:
- Guides Claude's behavior in the absence of data
- Not placeholder ads or "missing" notices
- Each fallback tells Claude what to do, not just what's absent