javi-forge 0.1.0

package/ai-config/skills/workflow/git-github/SKILL.md

@@ -0,0 +1,334 @@
+---
+name: git-github
+description: >
+  Git version control and GitHub collaboration workflows with conventional commits, branch strategies, and CI/CD.
+  Trigger: git, github, version control, branching, commits, pull request, CI/CD
+tools:
+  - Read
+  - Write
+  - Bash
+  - Grep
+metadata:
+  author: plataforma-industrial
+  version: "2.0"
+  tags: [git, github, version-control, ci-cd]
+  updated: "2026-02"
+---
+
+# Git & GitHub Workflow
+
+## Branching Strategy: GitHub Flow
+
+```
+main (production)
+  |
+  +-- feature/TASK-123-description
+  |     └── (merge via PR)
+  |
+  +-- fix/TASK-456-bug-fix
+  |     └── (merge via PR)
+  |
+  └── hotfix/TASK-789-critical
+        └── (merge via PR, immediate deploy)
+```
+
+### Rules
+1. `main` always deployable
+2. Features in short-lived branches (< 1 week)
+3. PRs small (< 400 lines)
+4. Hotfixes direct to main via express PR
+
+## Conventional Commits
+
+### Format
+```
+<type>(<scope>): <description>
+
+[body]
+
+[footer]
+```
+
+### Types
+
+| Type | Use | Example |
+|------|-----|---------|
+| `feat` | New feature | `feat(auth): add social login` |
+| `fix` | Bug fix | `fix(api): resolve token expiration` |
+| `docs` | Documentation | `docs(readme): update setup guide` |
+| `style` | Formatting | `style: format with prettier` |
+| `refactor` | Code refactor | `refactor(db): simplify queries` |
+| `perf` | Performance | `perf(cache): reduce latency` |
+| `test` | Tests | `test(auth): add unit tests` |
+| `build` | Build/deps | `build: upgrade to node 20` |
+| `ci` | CI/CD | `ci: add e2e tests` |
+| `chore` | Maintenance | `chore: update .gitignore` |
+
+### Examples
+
+```bash
+# Simple feature
+git commit -m "feat(sensors): add validation"
+
+# With body
+git commit -m "fix(auth): resolve token race condition
+
+Added mutex lock around token refresh.
+
+Fixes #234"
+
+# Breaking change
+git commit -m "feat(api)!: change response format
+
+BREAKING CHANGE: 'items' field is now an object."
+```
+
+## Git Workflow
+
+### Start Feature
+
+```bash
+git checkout main
+git pull origin main
+git checkout -b feature/TASK-123-description
+```
+
+### During Development
+
+```bash
+# Frequent small commits
+git add src/feature/
+git commit -m "feat(feature): add component"
+
+# Sync with main
+git fetch origin main
+git rebase origin/main
+```
+
+### Prepare PR
+
+```bash
+# Clean up commits
+git rebase -i origin/main
+
+# Push
+git push origin feature/TASK-123 --force-with-lease
+```
+
+### After Merge
+
+```bash
+git checkout main
+git pull origin main
+git branch -d feature/TASK-123
+```
+
+## Pull Request Template
+
+```markdown
+## Description
+[Brief description of changes]
+
+## Type of Change
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Breaking change
+- [ ] Documentation
+
+## Changes
+- [Change 1]
+- [Change 2]
+
+## How to Test
+1. [Step 1]
+2. [Step 2]
+
+## Checklist
+- [ ] Tests added/updated
+- [ ] Documentation updated
+- [ ] Self-review completed
+```
+
+## Git Hooks (Husky)
+
+```bash
+# Install
+npm install -D husky
+npx husky init
+
+# Pre-commit
+echo 'npm run lint-staged' > .husky/pre-commit
+
+# Commit-msg
+echo 'npx commitlint --edit "$1"' > .husky/commit-msg
+```
+
+### lint-staged config
+
+```json
+{
+  "lint-staged": {
+    "*.{ts,tsx}": ["eslint --fix", "prettier --write"],
+    "*.{md,json,yaml}": ["prettier --write"]
+  }
+}
+```
+
+### commitlint config
+
+```javascript
+// commitlint.config.js
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'subject-case': [2, 'always', 'lower-case'],
+    'header-max-length': [2, 'always', 72],
+  },
+};
+```
+
+## GitHub Actions CI
+
+```yaml
+# .github/workflows/ci.yml
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+      - run: npm ci
+      - run: npm run lint
+      - run: npm run test
+```
+
+## Dependabot
+
+```yaml
+# .github/dependabot.yml
+version: 2
+updates:
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly
+    groups:
+      npm-deps:
+        patterns: ["*"]
+    commit-message:
+      prefix: "build(deps)"
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    commit-message:
+      prefix: "ci"
+```
+
+## Useful Commands
+
+### History
+```bash
+git log --oneline --graph --all
+git log --follow -p -- path/to/file
+git log --grep="keyword"
+git log -S "functionName" --source --all
+```
+
+### Undo
+```bash
+git checkout -- path/to/file      # Discard changes
+git reset HEAD path/to/file       # Unstage
+git reset --soft HEAD~1           # Undo commit, keep changes
+git reset --hard HEAD~1           # Undo commit, discard changes
+git revert abc1234                # Revert specific commit
+```
+
+### Stash
+```bash
+git stash push -m "WIP"
+git stash list
+git stash pop
+git stash apply stash@{2}
+```
+
+### Bisect
+```bash
+git bisect start
+git bisect bad                    # Current is broken
+git bisect good v1.0.0           # Known good
+# Test each commit, mark good/bad
+git bisect reset                 # When done
+```
+
+## .gitignore
+
+```gitignore
+# OS
+.DS_Store
+Thumbs.db
+
+# IDEs
+.idea/
+.vscode/
+
+# Dependencies
+node_modules/
+vendor/
+
+# Build
+dist/
+build/
+
+# Environment
+.env
+.env.local
+!.env.example
+
+# Logs
+*.log
+logs/
+
+# Secrets (NEVER commit)
+*.pem
+*.key
+credentials.json
+```
+
+## CODEOWNERS
+
+```
+# .github/CODEOWNERS
+
+* @tech-lead
+
+/apps/backend/   @backend-team
+/apps/frontend/  @frontend-team
+/.github/        @devops-team
+```
+
+## Best Practices
+
+1. **Atomic commits** - One logical change per commit
+2. **Descriptive branch names** - `feature/TASK-123-add-auth`
+3. **Rebase before merge** - Keep history clean
+4. **Never force push to main**
+5. **Protect main branch** - Require reviews and CI
+
+## Related Skills
+
+- `git-workflow`: Branch strategies
+- `devops-infra`: GitHub Actions
+- `technical-docs`: PR documentation

package/ai-config/skills/workflow/git-github/references/examples.md

@@ -0,0 +1,160 @@
+# Git Workflow Examples
+
+> Concrete command sequences for common git scenarios.
+> Referenced from [../SKILL.md](../SKILL.md) — load this file when you need step-by-step examples.
+
+---
+
+## 1. Feature Branch Workflow
+
+Full cycle from starting a feature to opening a pull request:
+
+```bash
+# 1. Start from up-to-date main
+git checkout main
+git pull origin main
+
+# 2. Create feature branch
+git checkout -b feat/user-authentication
+
+# 3. Work and commit incrementally
+git add src/auth/
+git commit -m "feat(auth): add JWT token generation"
+
+git add src/auth/ tests/auth/
+git commit -m "feat(auth): add login endpoint with validation"
+
+git add tests/auth/
+git commit -m "test(auth): add unit tests for JWT service"
+
+# 4. Keep branch up to date (rebase preferred over merge)
+git fetch origin
+git rebase origin/main
+
+# 5. Push and open PR
+git push origin feat/user-authentication
+gh pr create --title "feat: user authentication" --body "Closes #42"
+```
+
+---
+
+## 2. Hotfix Workflow
+
+Emergency fix that needs to go to production immediately:
+
+```bash
+# 1. Branch from main (production state)
+git checkout main
+git pull origin main
+git checkout -b hotfix/null-pointer-login
+
+# 2. Make the minimal fix
+git add src/auth/login.ts
+git commit -m "fix(auth): handle null user object on failed login"
+
+# 3. Merge to main
+git checkout main
+git merge --no-ff hotfix/null-pointer-login
+git tag -a v1.2.1 -m "Hotfix: null pointer on login"
+git push origin main --tags
+
+# 4. Also merge to develop to keep branches in sync
+git checkout develop
+git merge --no-ff hotfix/null-pointer-login
+git push origin develop
+
+# 5. Clean up
+git branch -d hotfix/null-pointer-login
+git push origin --delete hotfix/null-pointer-login
+```
+
+---
+
+## 3. Conventional Commit Examples
+
+Reference for commit message format: `<type>(<scope>): <description>`
+
+```bash
+# Features
+git commit -m "feat(auth): add OAuth2 login with Google"
+git commit -m "feat(api): add cursor-based pagination to /users endpoint"
+
+# Bug fixes
+git commit -m "fix(auth): prevent session fixation after login"
+git commit -m "fix(db): handle connection timeout with retry logic"
+
+# Chores (non-functional changes)
+git commit -m "chore(deps): bump express from 4.18.1 to 4.19.2"
+git commit -m "chore(ci): add node 20 to test matrix"
+
+# Documentation
+git commit -m "docs(api): add OpenAPI examples for /orders endpoint"
+git commit -m "docs(readme): update setup instructions for M1 Mac"
+
+# Refactoring
+git commit -m "refactor(auth): extract token validation into TokenService"
+git commit -m "refactor(orders): replace callback chain with async/await"
+
+# Tests
+git commit -m "test(auth): add integration tests for refresh token flow"
+
+# Breaking changes (note the ! or BREAKING CHANGE footer)
+git commit -m "feat(api)!: change /users pagination from offset to cursor"
+git commit -m "feat(auth): require email verification
+
+BREAKING CHANGE: users without verified email can no longer access protected routes"
+```
+
+---
+
+## 4. Resolving Merge Conflicts
+
+Step-by-step guide for resolving conflicts cleanly:
+
+```bash
+# 1. Start the merge/rebase that triggers conflicts
+git rebase origin/main
+# → CONFLICT (content): Merge conflict in src/users/service.ts
+
+# 2. See which files have conflicts
+git status
+# → both modified: src/users/service.ts
+
+# 3. Open the conflicting file — look for conflict markers:
+# <<<<<<< HEAD (your changes)
+# const timeout = 5000;
+# =======
+# const timeout = 3000;
+# >>>>>>> origin/main (incoming changes)
+
+# 4. Edit the file to resolve — remove markers, keep correct code:
+# const timeout = 5000;  # or merge both intentions if needed
+
+# 5. Stage the resolved file
+git add src/users/service.ts
+
+# 6. Continue the rebase (or merge)
+git rebase --continue
+# (use --abort to cancel and return to pre-rebase state)
+
+# 7. Verify the result
+git log --oneline -5
+git diff origin/main
+
+# 8. Push (force-with-lease is safer than --force after rebase)
+git push origin feat/my-branch --force-with-lease
+```
+
+### Conflict prevention tips
+
+```bash
+# Rebase frequently to minimize divergence
+git fetch origin && git rebase origin/main
+
+# Use rerere to remember conflict resolutions
+git config --global rerere.enabled true
+
+# See what will conflict before merging
+git merge --no-commit --no-ff origin/main
+git merge --abort  # undo the dry run
+```

package/ai-config/skills/workflow/git-workflow/SKILL.md

@@ -0,0 +1,214 @@
+---
+name: git-workflow
+description: >
+  Git workflow guide for feature branches, PRs, and releases.
+  Trigger: branching, commits, PRs, git workflow, merge, release, conventional commits
+tools:
+  - Bash
+  - Read
+metadata:
+  author: project-starter-framework
+  version: "2.0"
+  tags: [git, workflow, branching, pr, commits]
+  updated: "2026-02"
+---
+
+# Git Workflow
+
+GitHub Flow with develop branch for integration.
+
+## Branch Strategy
+
+```
+main (production)
+  ↑ PR (release)
+develop (integration)
+  ↑ PR (feature complete)
+feature/xxx (work)
+```
+
+## Branch Naming
+
+| Type | Pattern | Example |
+|------|---------|---------|
+| Feature | `feature/t-xxx-description` | `feature/t-001-add-auth` |
+| Fix | `fix/t-xxx-description` | `fix/t-015-login-bug` |
+| Hotfix | `hotfix/xxx` | `hotfix/critical-security` |
+| Release | `release/vX.Y.Z` | `release/v2.1.0` |
+
+## Daily Workflow
+
+### Start Work
+```bash
+# Update develop
+git checkout develop
+git pull origin develop
+
+# Create feature branch
+git checkout -b feature/t-001-description
+```
+
+### During Work
+```bash
+# Stage changes
+git add <specific-files>
+
+# Commit (conventional format)
+git commit -m "feat(scope): description"
+
+# Push (CI-Local validates first)
+git push -u origin feature/t-001-description
+```
+
+### Create PR
+```bash
+gh pr create --base develop --title "feat: T-001 description" --body "
+## Summary
+- What this PR does
+
+## Test Plan
+- How to test
+
+## Related
+- Closes #123
+"
+```
+
+### After Review
+```bash
+# Merge PR (squash recommended)
+gh pr merge <number> --squash
+
+# Delete local branch
+git checkout develop
+git branch -d feature/t-001-description
+```
+
+## Commit Convention
+
+Format: `type(scope): description`
+
+### Types
+| Type | Use |
+|------|-----|
+| `feat` | New feature |
+| `fix` | Bug fix |
+| `refactor` | Code change (no feature/fix) |
+| `docs` | Documentation only |
+| `test` | Tests only |
+| `chore` | Maintenance |
+| `style` | Formatting |
+| `perf` | Performance |
+
+### Examples
+```
+feat(auth): add JWT token refresh
+fix(api): handle null response
+refactor(core): simplify validation logic
+docs(readme): update installation steps
+test(auth): add login edge cases
+chore(deps): update Spring Boot to 4.0
+```
+
+## AI Attribution Rules
+
+**NEVER include in commits/PRs:**
+- `Co-authored-by: Claude`
+- `Made by Claude/GPT/AI`
+- `Generated by AI`
+- `@anthropic.com` / `@openai.com`
+- Model names (claude, gpt-4, etc.)
+
+Git hooks automatically block these patterns.
+
+## Release Process
+
+### Prepare Release
+```bash
+git checkout develop
+git pull
+
+# Create release branch
+git checkout -b release/v2.1.0
+
+# Update version, changelog
+# ...
+
+git commit -m "chore(release): prepare v2.1.0"
+git push -u origin release/v2.1.0
+```
+
+### Merge to Main
+```bash
+gh pr create --base main --title "Release v2.1.0"
+# After approval:
+gh pr merge --merge
+```
+
+### Tag Release
+```bash
+git checkout main
+git pull
+git tag -a v2.1.0 -m "Release v2.1.0"
+git push origin v2.1.0
+```
+
+### Back-merge to Develop
+```bash
+git checkout develop
+git merge main
+git push
+```
+
+## Emergency Hotfix
+
+```bash
+# Branch from main
+git checkout main
+git checkout -b hotfix/critical-fix
+
+# Fix and commit
+git commit -m "fix(critical): description"
+
+# PR directly to main
+gh pr create --base main
+
+# After merge, back-merge to develop
+git checkout develop
+git merge main
+git push
+```
+
+## Useful Commands
+
+```bash
+# View branch status
+git branch -vv
+
+# Clean merged branches
+git branch --merged develop | grep -v develop | xargs git branch -d
+
+# Interactive rebase (before PR)
+git rebase -i develop
+
+# Amend last commit
+git commit --amend
+
+# Stash changes
+git stash
+git stash pop
+```
+
+## Pre-Push Checklist
+
+1. ✅ Code formatted (`./gradlew spotlessApply`)
+2. ✅ Tests pass locally
+3. ✅ No AI attribution in commits
+4. ✅ Commit messages follow convention
+5. ✅ CI-Local passes (`./ci-local.sh full`)
+
+## Related Skills
+
+- `git-github`: GitHub CLI and API
+- `devops-infra`: CI/CD integration
+- `technical-docs`: Commit documentation