javi-forge 1.1.0 → 1.3.0

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

@@ -1,334 +0,0 @@
----
-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

@@ -1,160 +0,0 @@
-# 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

@@ -1,214 +0,0 @@
----
-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