Skip to content

Latest commit

 

History

History
88 lines (64 loc) · 4.83 KB

File metadata and controls

88 lines (64 loc) · 4.83 KB

Components, Skills & Presets

Back to README


Components

Component ID Description
Engram engram Persistent cross-session memory via MCP — auto-detection of project name, full-text search, git sync, project consolidation. See engram repo
SDD sdd Spec-Driven Development workflow (9 phases) — the agent handles SDD organically when the task warrants it, or when you ask; you don't need to learn the commands
Skills skills Curated coding skill library
Context7 context7 MCP server for live framework/library documentation
Persona persona Managed Gentleman/neutral persona injection, or unmanaged custom persona mode
Permissions permissions Security-first defaults and guardrails. Applied to Claude Code and OpenCode (the two adapters with permissions overlay support). Default sensitive-paths deny list: ~/.ssh/*, ~/.ssh/**/*, **/*.pem, **/*.key, **/.env*, ~/.credentials/*, ~/.aws/credentials, ~/.config/gh/hosts.yml, ~/Library/Keychains/*, **/secrets/*, **/*.p12, **/*.pfx
GGA gga Gentleman Guardian Angel — AI provider switcher
Theme theme Gentleman Kanagawa theme overlay

GGA Behavior

gentle-ai --component gga installs/provisions the gga binary globally on your machine.

It does not run project-level hook setup automatically (gga init / gga install) because that should be an explicit decision per repository.

After global install, enable GGA per project with:

gga init
gga install

Skills

Included Skills (installed by gentle-ai)

20 skill files organized by category, embedded in the binary and injected into your agent's configuration:

SDD (Spec-Driven Development)

Skill ID Description
SDD Init sdd-init Bootstrap SDD context in a project
SDD Explore sdd-explore Investigate codebase before committing to a change
SDD Propose sdd-propose Create change proposal with intent, scope, approach
SDD Spec sdd-spec Write specifications with requirements and scenarios
SDD Design sdd-design Technical design with architecture decisions
SDD Tasks sdd-tasks Break down a change into implementation tasks
SDD Apply sdd-apply Implement tasks following specs and design
SDD Verify sdd-verify Validate implementation matches specs
SDD Archive sdd-archive Sync delta specs to main specs and archive
SDD Onboard sdd-onboard Guided end-to-end SDD walkthrough on the real codebase
Judgment Day judgment-day Parallel adversarial review — two independent judges review the same target

Foundation

Skill ID Description
Go Testing go-testing Go testing patterns including Bubbletea TUI testing
Skill Creator skill-creator Create new AI agent skills following the Agent Skills spec
Branch & PR branch-pr PR creation workflow with conventional commits, branch naming, and issue-first enforcement
Issue Creation issue-creation Issue filing workflow with bug report and feature request templates
Skill Registry skill-registry Build an index of installed skills with triggers, scopes, and exact SKILL.md paths
Chained PR chained-pr Plan and create reviewable stacked/chained pull requests
Cognitive Doc Design cognitive-doc-design Write docs that reduce review and onboarding cognitive load
Comment Writer comment-writer Draft warm, direct collaboration comments and review replies
Work Unit Commits work-unit-commits Split implementation into reviewable work units

These foundation skills are installed by default with both the full-gentleman (Dev Stack + Polish) and ecosystem-only (Dev Stack) presets.

Coding Skills (separate repository)

For framework-specific skills (React 19, Angular, TypeScript, Tailwind 4, Zod 4, Playwright, etc.), see Gentleman-Programming/Gentleman-Skills. These are maintained by the community and installed separately by cloning the repo and copying skills to your agent's skills directory.


Presets

Preset ID What's Included
Dev Stack + Polish full-gentleman All components (Engram + SDD + Skills + Context7 + GGA + Permissions + Theme) + all skills
Dev Stack ecosystem-only Core components (Engram + SDD + Skills + Context7 + GGA) + all skills
Memory Only minimal Engram + SDD skills only
Custom custom You choose components and skills manually while keeping any existing persona/settings unmanaged

Persona is selected separately on the Persona screen and applied independently of the preset.