Reference devgen documentation by cloning the repo locally. devgen is a Go code generation toolset with AI Rules system for CodeBuddy, Cursor, and Kiro.
When devgen is referenced (tool name, GitHub URL, or any code generation question), I clone the devgen repository locally for thorough analysis using local file tools to understand:
// tool:@annotation)Clone to a temp directory using shallow clone:
git clone --depth 1 https://github.com/tlipoca9/devgen /tmp/devgen
Analyze locally using file tools:
/tmp/devgen/:
README.md - Overview and quick startgenkit/genkit.go - Core Generator APIgenkit/types.go - Type definitions and annotation parsinggenkit/adapter.go - AgentAdapter interfacegenkit/adapter_registry.go - Adapter managementgenkit/plugin.go - Plugin systemcmd/devgen/rules/devgen-rules.md - AI Rules documentationdocs/plugin.md - Plugin development guideReuse existing clones — if /tmp/devgen already exists, don't re-clone
Clean up when analysis is complete:
rm -rf /tmp/devgen
| Interface | Purpose |
|---|---|
Tool | Core code generation (required) |
ConfigurableTool | IDE autocompletion metadata |
ValidatableTool | Real-time annotation diagnostics |
RuleTool | AI Rules generation for IDEs |
// toolname:@annotation(args)
// toolname:@annotation.subannotation(args)
Example:
// enumgen:@enum(string, json)
// validategen:@required
// validategen:@email
| Agent | Output Directory | File Extension |
|---|---|---|
| Kiro | .kiro/steering/ | .md |
| CodeBuddy | .codebuddy/rules/ | .mdc |
| Cursor | .cursor/rules/ | .mdc |
/tmp/devgen/genkit/genkit.go - Core Generator API/tmp/devgen/genkit/types.go - Annotation parsing (ParseAnnotations, HasAnnotation)/tmp/devgen/genkit/adapter.go - AgentAdapter interface/tmp/devgen/genkit/adapter_codebuddy.go - CodeBuddy adapter implementation/tmp/devgen/genkit/adapter_cursor.go - Cursor adapter implementation/tmp/devgen/genkit/adapter_kiro.go - Kiro adapter implementation/tmp/devgen/cmd/devgen/rules/devgen-rules.md - AI Rules system documentation/tmp/devgen/docs/plugin.md - Plugin development guide/tmp/devgen/docs/rules-adapter.md - Rules adapter documentation