Stats
Actions
Tags
From faf
Context-aware git commits powered by FAF. Reads .faf project DNA to generate meaningful commit messages. Use when committing code changes. Foundation Layer integration ensures commits reflect project goals.
How this skill is triggered — by the user, by Claude, or both
Slash command
/faf:commitThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
**"Commits that understand your project."**
"Commits that understand your project."
project/
├── package.json ← npm reads this
├── project.faf ← AI reads this
├── README.md
└── src/
"package.json wasn't built for this, .faf was" — .faf Inventor
"package.json gives me a list of dependencies, .faf shows me how to use them" — Claude Code (Anthropic)
Once you get used to it, it's just another file helping you code.
When activated, commit reads from your project's foundation:
🔗 CONNECTING TO FOUNDATION
Reading: project.faf
Context: project.goal, stack, conventions
Status: ALIGNED
✅ Commit context loaded from .faf
Your commits now reflect project DNA
Activate when:
/commitWithout FAF:
git commit -m "fix bug"
git commit -m "update code"
git commit -m "changes"
With FAF Foundation:
git commit -m "fix: resolve API timeout in voice streaming
Addresses issue where Grok voice responses would timeout
after 30s. Now properly handles chunked streaming.
Context: FAF-Voice browser-to-xAI integration"
The difference: FAF provides project.goal, human_context.why, and stack information that makes commits meaningful.
Before generating commit message, read from .faf:
# From project.faf
project:
name: "faf-voice"
goal: "Browser-to-xAI voice client with eternal memory"
human_context:
why: "Prove voice persistence to xAI"
what: "Zero drift, zero re-explain voice assistant"
Run git commands to understand what changed:
git status
git diff --staged
git diff
Use .faf context to create meaningful commit:
Format:
<type>: <short description>
<optional body with context from .faf>
<optional footer>
Types (conventional commits):
feat: - New featurefix: - Bug fixdocs: - Documentationstyle: - Formatting (no code change)refactor: - Code restructure (no behavior change)test: - Adding testschore: - Maintenance tasksgit add <files>
git commit -m "<message>"
feat: add voice streaming to Grok integration
Implements real-time voice streaming from browser to xAI API.
Uses chunked transfer encoding for low-latency responses.
Part of FAF-Voice demo for xAI partnership.
fix: resolve memory leak in voice session handler
Sessions were not properly cleaned up after disconnect.
Now implements proper cleanup in WebSocket close handler.
Fixes eternal memory persistence issue.
refactor: extract voice codec logic to separate module
Moves audio encoding/decoding to dedicated VoiceCodec class.
Improves testability and prepares for multi-codec support.
No behavior change - all existing tests pass.
This skill uses Claude Code patterns:
| Field | Usage |
|---|---|
project.name | Prefix for multi-repo commits |
project.goal | Context for "why" in commit body |
human_context.why | Business reason for change |
human_context.what | Feature context |
stack.* | Technical context |
User: /commit
Claude: Let me check your .faf for project context.
[Reads project.faf]
[Runs git status]
[Runs git diff --staged]
Based on your changes and project context, here's the commit:
feat: implement voice session persistence
Adds WebSocket reconnection with session recovery.
Voice context survives browser refresh and network drops.
Part of FAF-Voice eternal memory demo.
[Executes: git commit -m "..."]
✅ Committed! Your changes are now part of the project history.
/pr - Create pull request (uses commit context)/review - Review code changes/release - Version and changelog.faf is the format. project.faf is the file. 100% 🏆 AI Readiness is the result.
FAF Foundation Layer - Native to Claude Code "Commits that understand your project."
npx claudepluginhub wolfe-jam/faf-skillsCreates git commits with repo detection, pre-commit checks, submodule support, and conventional messages. Activates on /commit or git commit requests.
Manages Git commit workflow using Conventional Commits format with safety protocols. Creates, validates, executes commits; handles hooks, PRs, and safety checks before operations.
Creates semantic git commits with conventional commit format, stages changes, and pushes to remote. Handles pre-commit hooks and writes meaningful commit messages.