From 1c45c3f5282a363f3cb3491dd53b17b75b87d2b5 Mon Sep 17 00:00:00 2001 From: emredursun Date: Sun, 22 Mar 2026 13:53:12 +0100 Subject: [PATCH 1/3] feat(gitflow): add GitFlow branching strategy with dev integration branch - Create dev branch as integration target for all feature work - Update CI pipeline to run on both main and dev branches - Add PR template with conventional commit checklist - Rewrite git-workflow rules with full GitFlow branch strategy - Update CONTRIBUTING.md with GitFlow workflow documentation - Update /pr workflow to auto-detect GitFlow and target dev --- .agent/rules/git-workflow.md | 121 +++++++++++++++++++++++++++---- .agent/workflows/pr.md | 2 +- .github/PULL_REQUEST_TEMPLATE.md | 45 ++++++++++++ .github/workflows/ci.yml | 4 +- CONTRIBUTING.md | 102 ++++++++++++++++---------- 5 files changed, 217 insertions(+), 57 deletions(-) create mode 100644 .github/PULL_REQUEST_TEMPLATE.md diff --git a/.agent/rules/git-workflow.md b/.agent/rules/git-workflow.md index 151cf76..38fe1b9 100644 --- a/.agent/rules/git-workflow.md +++ b/.agent/rules/git-workflow.md @@ -1,6 +1,7 @@ -# Git Workflow Rules +# Git Workflow Rules — GitFlow > **Priority**: HIGH — Enforced by hooks +> **Strategy**: GitFlow with `dev` as integration branch, `main` as production > [!CAUTION] > **PUSH POLICY**: NEVER push commits during implementation or task work. @@ -8,6 +9,80 @@ > The pre-push hook runs the full LOCAL-CI-GATE (lint, type-check, tests, build) which takes 60-160 seconds. > Premature pushes waste time and block the agent. Only push once, at session end, after all work is verified. +--- + +## Branch Strategy + +``` +main (production — protected, release-only) + └── dev (integration — all features merge here first) + ├── feat/add-python-agent + ├── fix/cli-init-error + ├── refactor/loading-engine + └── docs/update-readme +``` + +### Branch Types + +| Branch | Base | Merges Into | Purpose | +| :--- | :--- | :--- | :--- | +| `main` | — | — | Production releases only. Never commit directly. | +| `dev` | `main` | `main` (via release PR) | Integration branch. All feature work targets here. | +| `feat/*` | `dev` | `dev` | New features | +| `fix/*` | `dev` | `dev` | Bug fixes | +| `refactor/*` | `dev` | `dev` | Code restructuring | +| `docs/*` | `dev` | `dev` | Documentation | +| `test/*` | `dev` | `dev` | Test additions | +| `chore/*` | `dev` | `dev` | Maintenance | +| `hotfix/*` | `main` | `main` AND `dev` | Critical production fixes | + +### Branch Naming Convention + +``` +type/short-description +``` + +Examples: +- `feat/pr-toolkit-v2` +- `fix/windows-eperm-retry` +- `hotfix/security-patch-auth` +- `chore/bump-vitest-v4` + +--- + +## Merge Rules + +### Feature → dev + +1. Create feature branch from `dev` +2. Develop and commit locally (conventional commits) +3. Push feature branch to remote +4. Create PR targeting `dev` +5. Wait for CI checks to pass +6. Wait for reviewer approval (gemini-code-assist or human) +7. Squash-merge into `dev` + +### dev → main (Release) + +1. Ensure `dev` is stable (all CI green, no WIP) +2. Create release PR: `dev` → `main` +3. PR title: `release: vX.Y.Z` +4. Wait for ALL CI checks to pass +5. Wait for human review approval +6. Merge (no squash — preserve history) +7. Tag the release: `git tag vX.Y.Z` +8. Run `npm publish` from `main` +9. Merge `main` back into `dev` (sync release commit) + +### hotfix → main + +1. Create `hotfix/*` branch from `main` +2. Fix the issue with minimal changes +3. Create PR targeting `main` +4. After merge, cherry-pick or merge `main` into `dev` + +--- + ## Commit Format ``` @@ -20,30 +95,46 @@ type(scope): description ### Types -| Type | Use | -| :--------- | :----------------- | -| `feat` | New feature | -| `fix` | Bug fix | -| `docs` | Documentation | +| Type | Use | +| :--- | :--- | +| `feat` | New feature | +| `fix` | Bug fix | +| `docs` | Documentation | | `refactor` | Code restructuring | -| `test` | Test additions | -| `chore` | Maintenance | - -## Branch Naming +| `test` | Test additions | +| `chore` | Maintenance | +| `perf` | Performance optimization | +| `ci` | CI/CD changes | -- `feature/` — New features -- `fix/` — Bug fixes -- `refactor/` — Code improvements +--- ## Before Commit -- [ ] All tests pass +- [ ] All tests pass (`npm test`) - [ ] Lint passes - [ ] Build succeeds - [ ] No secrets in code +- [ ] Counts synced if components added/removed ## Pull Requests -- **REQUIRE** code review +- **REQUIRE** code review (gemini-code-assist + human) - **INCLUDE** test coverage - **LINK** to issue/ticket +- **TARGET** `dev` for features/fixes, `main` for releases/hotfixes only +- **NEVER** create a PR from `main` or `dev` directly +- **CONVENTIONAL** title format: `type(scope): description` + +--- + +## Session-End Protocol (Commit & Push) + +When the user says "Commit & Push" or similar: + +1. **Branch Check**: Verify you're on a feature branch (not `main` or `dev`) +2. **Stage Changes**: `git add` relevant files (never `git add -A` blindly) +3. **Commit**: Use conventional commit message +4. **Push**: Push feature branch to remote with `-u` flag +5. **Create PR**: Target `dev` branch (not `main`) +6. **Report**: Share PR URL and wait for CI + reviewer approval +7. **Do NOT merge**: User decides when to merge after reviews pass diff --git a/.agent/workflows/pr.md b/.agent/workflows/pr.md index 4ea0a06..2a9fb8a 100644 --- a/.agent/workflows/pr.md +++ b/.agent/workflows/pr.md @@ -52,7 +52,7 @@ commit-types: [feat, fix, refactor, perf, chore, docs, test] | Command | Action | | :---------------------- | :--------------------------------------------------- | -| `/pr` | Create PR targeting default branch (`main`) | +| `/pr` | Create PR targeting integration branch (`dev` if GitFlow, `main` if trunk-based) | | `/pr [target]` | Create PR targeting specified branch (e.g., `/pr dev`) | | `/pr --draft` | Create PR as draft (may not trigger CI) | | `/pr --draft [target]` | Create draft PR targeting specified branch | diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..7b4642a --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,45 @@ +## Summary + + + +- + +## Type of Change + + + +- [ ] `feat` — New feature +- [ ] `fix` — Bug fix +- [ ] `refactor` — Code restructuring (no behavior change) +- [ ] `perf` — Performance improvement +- [ ] `docs` — Documentation only +- [ ] `test` — Test additions or fixes +- [ ] `chore` — Maintenance (deps, config, CI) +- [ ] `ci` — CI/CD pipeline changes + +## Breaking Changes + + + +- [ ] No breaking changes +- [ ] Yes (describe below) + +## Test Plan + + + +- [ ] `npm test` passes locally (all tests green) +- [ ] Manual testing performed +- [ ] New tests added for changed behavior +- [ ] No secrets or PII in diff + +## Checklist + +- [ ] PR title follows conventional commits: `type(scope): description` +- [ ] Branch synced with target (no conflicts) +- [ ] Self-reviewed the diff +- [ ] Counts synchronized (manifest, README, CheatSheet, CLI) if components added/removed + +## Related Issues + + diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index e483a42..553ae19 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -2,9 +2,9 @@ name: Antigravity AI Kit CI on: push: - branches: [main] + branches: [main, dev] pull_request: - branches: [main] + branches: [main, dev] permissions: contents: read diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c711463..6bbeedf 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,6 +1,6 @@ # Contributing to Antigravity AI Kit -Thank you for your interest in contributing to **Antigravity AI Kit**! 🚀 +Thank you for your interest in contributing to **Antigravity AI Kit**! ## Getting Started @@ -19,18 +19,49 @@ Thank you for your interest in contributing to **Antigravity AI Kit**! 🚀 npm test ``` -## Development Workflow - -### Branch Naming +## GitFlow Branching Strategy -Use conventional branch names: +We use **GitFlow** with `dev` as the integration branch and `main` as the production branch. ``` -feat/add-python-agent -fix/cli-init-error -docs/update-readme +main (production — releases only) + └── dev (integration — all features merge here) + ├── feat/your-feature + ├── fix/your-bugfix + └── docs/your-docs ``` +### Branch Rules + +| Branch Type | Base | Target | Example | +|:---|:---|:---|:---| +| `feat/*` | `dev` | `dev` | `feat/add-python-agent` | +| `fix/*` | `dev` | `dev` | `fix/cli-init-error` | +| `refactor/*` | `dev` | `dev` | `refactor/loading-engine` | +| `docs/*` | `dev` | `dev` | `docs/update-readme` | +| `chore/*` | `dev` | `dev` | `chore/bump-deps` | +| `hotfix/*` | `main` | `main` + `dev` | `hotfix/security-patch` | + +**Important**: Always create your branch from `dev`, not `main`. PRs should target `dev`. + +### Creating a Feature Branch + +```bash +git checkout dev +git pull origin dev +git checkout -b feat/your-feature-name +``` + +## Development Workflow + +1. **Create branch** from `dev` (see above) +2. **Make changes** and commit with conventional messages +3. **Run tests**: `npm test` +4. **Push** your branch: `git push -u origin feat/your-feature-name` +5. **Create PR** targeting `dev` +6. **Wait** for CI checks and reviewer approval +7. **Squash-merge** into `dev` + ### Commit Messages We follow **Conventional Commits**: @@ -38,7 +69,7 @@ We follow **Conventional Commits**: ``` feat(agents): add python-specialist agent fix(cli): handle missing .agent directory gracefully -docs(readme): update skills count to 28 +docs(readme): update skills count to 35 test(security): add injection scan for new patterns chore(deps): update vitest to 3.x ``` @@ -46,9 +77,9 @@ chore(deps): update vitest to 3.x ### Running Tests ```bash -npm test # Run all 43 tests +npm test # Run all tests npx vitest run --reporter=verbose # Verbose output -npx vitest watch # Watch mode +npx vitest watch # Watch mode ``` Test suites: @@ -61,9 +92,9 @@ Test suites: Before submitting a PR, ensure: - [ ] All tests pass (`npm test`) - [ ] No hardcoded secrets -- [ ] No BeSync-specific language -- [ ] Counts are synchronized (manifest, README, rules.md, CLI) +- [ ] Counts are synchronized (manifest, README, CheatSheet, CLI) - [ ] New agents/skills include YAML frontmatter +- [ ] PR title uses conventional commit format ## Adding New Components @@ -80,39 +111,35 @@ Before submitting a PR, ensure: Instructions... ``` 2. Add entry to `.agent/manifest.json` -3. Update count in `README.md`, `.agent/rules.md`, `bin/ag-kit.js` +3. Update count in `README.md`, `.agent/CheatSheet.md`, `bin/ag-kit.js` 4. Run `npm test` to verify structural integrity ### Adding a Skill -1. Create `.agent/skills/your-skill/SKILL.md` with frontmatter: - ```markdown - --- - name: your-skill - description: What this skill does - triggers: [keyword1, keyword2] - --- - # Your Skill - ## Overview - ... - ``` +1. Create `.agent/skills/your-skill/SKILL.md` with frontmatter 2. Add entry to `.agent/manifest.json` 3. Update counts everywhere (see Adding an Agent, step 3) 4. Run `npm test` ### Adding a Workflow -1. Create `.agent/workflows/your-workflow.md` with frontmatter: - ```markdown - --- - description: What this workflow does - --- - # Steps... - ``` +1. Create `.agent/workflows/your-workflow.md` with frontmatter 2. Add entry to `.agent/manifest.json` 3. Update counts 4. Run `npm test` +## Release Process + +Releases follow the GitFlow release cycle: + +1. All features merged into `dev` and stable +2. Create release PR: `dev` → `main` with title `release: vX.Y.Z` +3. CI checks pass, human review approved +4. Merge into `main` +5. Tag: `git tag vX.Y.Z` +6. Publish: `npm publish` +7. Merge `main` back into `dev` + ## Code Standards - **Zero dependencies** — the core kit uses only Node.js built-ins @@ -122,15 +149,12 @@ Before submitting a PR, ensure: ## Pull Request Process -1. Create a PR against `main` -2. Describe what changed and why +1. Create a PR against `dev` (not `main`) +2. Fill in the PR template completely 3. Ensure all CI checks pass -4. Request review +4. Wait for reviewer approval (gemini-code-assist + human) +5. Squash-merge after approval ## Questions? Open an [issue](https://github.com/besync-labs/antigravity-ai-kit/issues) or start a [discussion](https://github.com/besync-labs/antigravity-ai-kit/discussions). - ---- - -**Thank you for helping make Antigravity AI Kit better!** 💜 From f9187b0164de4368ff32de0c9f1f1965a6ce08cb Mon Sep 17 00:00:00 2001 From: emredursun Date: Sun, 22 Mar 2026 15:52:46 +0100 Subject: [PATCH 2/3] chore: migrate repository URLs from besync-labs to devran-ai/kit Update all repository references across 17 files: - package.json, manifest.json: repository URL - README, CONTRIBUTING, docs: GitHub links - mkdocs.yml, robots.txt: GitHub Pages URLs - bin/ag-kit.js, create-antigravity-app: CLI output URLs --- .agent/manifest.json | 2 +- .agent/skills/i18n-localization/SKILL.md | 2 +- CHANGELOG.md | 26 ++++++++++++------------ CONTRIBUTING.md | 2 +- README.md | 10 ++++----- bin/ag-kit.js | 2 +- create-antigravity-app/README.md | 4 ++-- create-antigravity-app/index.js | 2 +- create-antigravity-app/package.json | 6 +++--- docs/contributing.md | 4 ++-- docs/getting-started.md | 2 +- docs/github-repository-settings.md | 2 +- docs/google-search-console-setup.md | 4 ++-- docs/overrides/main.html | 6 +++--- docs/robots.txt | 2 +- mkdocs.yml | 14 ++++++------- package.json | 6 +++--- 17 files changed, 48 insertions(+), 48 deletions(-) diff --git a/.agent/manifest.json b/.agent/manifest.json index 659b595..6d9b6e2 100644 --- a/.agent/manifest.json +++ b/.agent/manifest.json @@ -3,7 +3,7 @@ "kitVersion": "3.10.1", "lastAuditedAt": null, "description": "Antigravity AI Kit — Trust-Grade AI Development Framework", - "repository": "https://github.com/besync-labs/antigravity-ai-kit", + "repository": "https://github.com/devran-ai/kit", "capabilities": { "agents": { "count": 20, diff --git a/.agent/skills/i18n-localization/SKILL.md b/.agent/skills/i18n-localization/SKILL.md index 24ace39..f581f72 100644 --- a/.agent/skills/i18n-localization/SKILL.md +++ b/.agent/skills/i18n-localization/SKILL.md @@ -188,4 +188,4 @@ export const config = { --- -> **Source**: Antigravity AI Kit — [antigravity-ai-kit](https://github.com/besync-labs/antigravity-ai-kit) +> **Source**: Antigravity AI Kit — [antigravity-ai-kit](https://github.com/devran-ai/kit) diff --git a/CHANGELOG.md b/CHANGELOG.md index a52be0e..01c1434 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -445,16 +445,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Session management architecture - PAAL continuous learning cycle -[3.8.0]: https://github.com/besync-labs/antigravity-ai-kit/compare/v3.7.0...v3.8.0 -[3.7.0]: https://github.com/besync-labs/antigravity-ai-kit/compare/v3.6.0...v3.7.0 -[3.6.0]: https://github.com/besync-labs/antigravity-ai-kit/compare/v3.5.0...v3.6.0 -[3.5.0]: https://github.com/besync-labs/antigravity-ai-kit/compare/v3.4.1...v3.5.0 -[3.4.1]: https://github.com/besync-labs/antigravity-ai-kit/compare/v3.3.1...v3.4.1 -[3.3.1]: https://github.com/besync-labs/antigravity-ai-kit/compare/v3.3.0...v3.3.1 -[3.3.0]: https://github.com/besync-labs/antigravity-ai-kit/compare/v3.2.0...v3.3.0 -[3.2.0]: https://github.com/besync-labs/antigravity-ai-kit/compare/v3.1.0...v3.2.0 -[3.1.0]: https://github.com/besync-labs/antigravity-ai-kit/compare/v3.0.1...v3.1.0 -[3.0.1]: https://github.com/besync-labs/antigravity-ai-kit/compare/v3.0.0...v3.0.1 -[3.0.0]: https://github.com/besync-labs/antigravity-ai-kit/compare/v2.1.0...v3.0.0 -[2.1.0]: https://github.com/besync-labs/antigravity-ai-kit/compare/v2.0.0...v2.1.0 -[2.0.0]: https://github.com/besync-labs/antigravity-ai-kit/releases/tag/v2.0.0 +[3.8.0]: https://github.com/devran-ai/kit/compare/v3.7.0...v3.8.0 +[3.7.0]: https://github.com/devran-ai/kit/compare/v3.6.0...v3.7.0 +[3.6.0]: https://github.com/devran-ai/kit/compare/v3.5.0...v3.6.0 +[3.5.0]: https://github.com/devran-ai/kit/compare/v3.4.1...v3.5.0 +[3.4.1]: https://github.com/devran-ai/kit/compare/v3.3.1...v3.4.1 +[3.3.1]: https://github.com/devran-ai/kit/compare/v3.3.0...v3.3.1 +[3.3.0]: https://github.com/devran-ai/kit/compare/v3.2.0...v3.3.0 +[3.2.0]: https://github.com/devran-ai/kit/compare/v3.1.0...v3.2.0 +[3.1.0]: https://github.com/devran-ai/kit/compare/v3.0.1...v3.1.0 +[3.0.1]: https://github.com/devran-ai/kit/compare/v3.0.0...v3.0.1 +[3.0.0]: https://github.com/devran-ai/kit/compare/v2.1.0...v3.0.0 +[2.1.0]: https://github.com/devran-ai/kit/compare/v2.0.0...v2.1.0 +[2.0.0]: https://github.com/devran-ai/kit/releases/tag/v2.0.0 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 6bbeedf..1badd31 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -157,4 +157,4 @@ Releases follow the GitFlow release cycle: ## Questions? -Open an [issue](https://github.com/besync-labs/antigravity-ai-kit/issues) or start a [discussion](https://github.com/besync-labs/antigravity-ai-kit/discussions). +Open an [issue](https://github.com/devran-ai/kit/issues) or start a [discussion](https://github.com/devran-ai/kit/discussions). diff --git a/README.md b/README.md index 9475afa..2cfd13e 100644 --- a/README.md +++ b/README.md @@ -714,15 +714,15 @@ MIT License — See [LICENSE](LICENSE) for details. ## 🔗 Links -- **Repository**: [github.com/besync-labs/antigravity-ai-kit](https://github.com/besync-labs/antigravity-ai-kit) -- **Documentation**: [besync-labs.github.io/antigravity-ai-kit](https://besync-labs.github.io/antigravity-ai-kit) +- **Repository**: [github.com/devran-ai/kit](https://github.com/devran-ai/kit) +- **Documentation**: [devran-ai.github.io/kit](https://devran-ai.github.io/kit) - **Origin**: Derived from BeSync Trust-Grade AI Governance --- ## 📖 Contributor Guide -Want to use Antigravity AI Kit in your project? The **[Contributor Guide](https://besync-labs.github.io/antigravity-ai-kit/contributor-guide/)** covers the full end-to-end lifecycle: +Want to use Antigravity AI Kit in your project? The **[Contributor Guide](https://devran-ai.github.io/kit/contributor-guide/)** covers the full end-to-end lifecycle: | Phase | What You’ll Learn | |:---|:---| @@ -734,7 +734,7 @@ Want to use Antigravity AI Kit in your project? The **[Contributor Guide](https: | **Quality Gates** | 5-gate pipeline: lint, types, tests, security, build | | **Completion** | Sprint retrospective, tracking updates, next sprint | -👉 **[Read the full guide →](https://besync-labs.github.io/antigravity-ai-kit/contributor-guide/)** +👉 **[Read the full guide →](https://devran-ai.github.io/kit/contributor-guide/)** --- @@ -754,5 +754,5 @@ _Antigravity AI Kit v3.5.0 extends these foundations with a 29-module runtime en

- ⭐ Star me on GitHub + ⭐ Star me on GitHub

diff --git a/bin/ag-kit.js b/bin/ag-kit.js index 2617e1e..a23c692 100644 --- a/bin/ag-kit.js +++ b/bin/ag-kit.js @@ -312,7 +312,7 @@ ${colors.bright}Quick start:${colors.reset} ${colors.cyan}/implement${colors.reset} Execute the plan ${colors.cyan}/verify${colors.reset} Run quality gates -${colors.yellow}📚 Documentation: https://github.com/besync-labs/antigravity-ai-kit${colors.reset} +${colors.yellow}📚 Documentation: https://github.com/devran-ai/kit${colors.reset} `); } } diff --git a/create-antigravity-app/README.md b/create-antigravity-app/README.md index f1e27e1..e43693f 100644 --- a/create-antigravity-app/README.md +++ b/create-antigravity-app/README.md @@ -1,6 +1,6 @@ # create-antigravity-app -> 🚀 Create a new project with [Antigravity AI Kit](https://github.com/besync-labs/antigravity-ai-kit) pre-configured. +> 🚀 Create a new project with [Antigravity AI Kit](https://github.com/devran-ai/kit) pre-configured. ## Quick Start @@ -48,4 +48,4 @@ Open your project in an AI-powered IDE and use these commands: ## License -MIT — [Antigravity AI Kit](https://github.com/besync-labs/antigravity-ai-kit) +MIT — [Antigravity AI Kit](https://github.com/devran-ai/kit) diff --git a/create-antigravity-app/index.js b/create-antigravity-app/index.js index 694b3c8..86649dc 100644 --- a/create-antigravity-app/index.js +++ b/create-antigravity-app/index.js @@ -304,7 +304,7 @@ ${colors.cyan}Quick start:${colors.reset} ${colors.green}/create${colors.reset} Build a new feature ${colors.green}/test${colors.reset} Write and run tests -${colors.dim}📚 https://github.com/besync-labs/antigravity-ai-kit${colors.reset} +${colors.dim}📚 https://github.com/devran-ai/kit${colors.reset} `); } diff --git a/create-antigravity-app/package.json b/create-antigravity-app/package.json index aaa869c..8cbf041 100644 --- a/create-antigravity-app/package.json +++ b/create-antigravity-app/package.json @@ -20,13 +20,13 @@ "license": "MIT", "repository": { "type": "git", - "url": "git+https://github.com/besync-labs/antigravity-ai-kit.git", + "url": "git+https://github.com/devran-ai/kit.git", "directory": "create-antigravity-app" }, "bugs": { - "url": "https://github.com/besync-labs/antigravity-ai-kit/issues" + "url": "https://github.com/devran-ai/kit/issues" }, - "homepage": "https://github.com/besync-labs/antigravity-ai-kit#readme", + "homepage": "https://github.com/devran-ai/kit#readme", "engines": { "node": ">=18.0.0" }, diff --git a/docs/contributing.md b/docs/contributing.md index 69266e4..e68f630 100644 --- a/docs/contributing.md +++ b/docs/contributing.md @@ -93,6 +93,6 @@ This checks: ## Questions? -- Open an [issue](https://github.com/besync-labs/antigravity-ai-kit/issues) +- Open an [issue](https://github.com/devran-ai/kit/issues) - Check existing discussions -- Review the [documentation](https://besync-labs.github.io/antigravity-ai-kit) +- Review the [documentation](https://devran-ai.github.io/kit) diff --git a/docs/getting-started.md b/docs/getting-started.md index 7c9af4f..73c4531 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -35,7 +35,7 @@ ag-kit update --dry-run # Preview changes without applying ```bash # 1. Clone the repository -git clone https://github.com/besync-labs/antigravity-ai-kit.git +git clone https://github.com/devran-ai/kit.git # 2. Copy .agent/ to your project cp -r antigravity-ai-kit/.agent/ your-project/.agent/ diff --git a/docs/github-repository-settings.md b/docs/github-repository-settings.md index 352b508..acb612b 100644 --- a/docs/github-repository-settings.md +++ b/docs/github-repository-settings.md @@ -38,7 +38,7 @@ ai-development Set the website field to: ``` -https://besync-labs.github.io/antigravity-ai-kit/ +https://devran-ai.github.io/kit/ ``` --- diff --git a/docs/google-search-console-setup.md b/docs/google-search-console-setup.md index 2fb0107..75d290b 100644 --- a/docs/google-search-console-setup.md +++ b/docs/google-search-console-setup.md @@ -8,7 +8,7 @@ 1. Go to [Google Search Console](https://search.google.com/search-console/welcome) 2. Select **URL prefix** method -3. Enter: `https://besync-labs.github.io/antigravity-ai-kit/` +3. Enter: `https://devran-ai.github.io/kit/` 4. Click **Continue** --- @@ -46,7 +46,7 @@ The sitemap URL is: ``` -https://besync-labs.github.io/antigravity-ai-kit/sitemap.xml +https://devran-ai.github.io/kit/sitemap.xml ``` --- diff --git a/docs/overrides/main.html b/docs/overrides/main.html index 7622739..3628fe3 100644 --- a/docs/overrides/main.html +++ b/docs/overrides/main.html @@ -15,11 +15,11 @@ /> @@ -38,6 +38,6 @@ /> {% endblock %} diff --git a/docs/robots.txt b/docs/robots.txt index 9b297cd..63b507a 100644 --- a/docs/robots.txt +++ b/docs/robots.txt @@ -1,3 +1,3 @@ User-agent: * Allow: / -Sitemap: https://besync-labs.github.io/antigravity-ai-kit/sitemap.xml +Sitemap: https://devran-ai.github.io/kit/sitemap.xml diff --git a/mkdocs.yml b/mkdocs.yml index 6de9367..2e0e51d 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,10 +1,10 @@ site_name: Antigravity AI Kit -site_url: https://besync-labs.github.io/antigravity-ai-kit/ +site_url: https://devran-ai.github.io/kit/ site_description: Trust-Grade AI Development Framework — 29-Module Runtime Engine, 20 Agents, 34 Skills, 37 Commands, 21 Workflows, 349 Tests site_author: Emre Dursun -repo_name: besync-labs/antigravity-ai-kit -repo_url: https://github.com/besync-labs/antigravity-ai-kit +repo_name: devran-ai/kit +repo_url: https://github.com/devran-ai/kit theme: name: material @@ -88,7 +88,7 @@ nav: extra: social: - icon: fontawesome/brands/github - link: https://github.com/besync-labs/antigravity-ai-kit + link: https://github.com/devran-ai/kit - icon: fontawesome/brands/linkedin link: https://www.linkedin.com/in/emre-dursun-nl/ generator: false @@ -103,9 +103,9 @@ extra: - property: og:description content: Trust-Grade AI Development Framework with a 29-module runtime engine, 20 agents, 34 skills, 37 commands, and 21 workflows - property: og:url - content: https://besync-labs.github.io/antigravity-ai-kit/ + content: https://devran-ai.github.io/kit/ - property: og:image - content: https://besync-labs.github.io/antigravity-ai-kit/assets/og-image.png + content: https://devran-ai.github.io/kit/assets/og-image.png - name: twitter:card content: summary_large_image - name: twitter:title @@ -113,6 +113,6 @@ extra: - name: twitter:description content: Trust-Grade AI Development Framework — 29-Module Runtime Engine, 20 Agents, 34 Skills, 37 Commands, 21 Workflows - name: twitter:image - content: https://besync-labs.github.io/antigravity-ai-kit/assets/og-image.png + content: https://devran-ai.github.io/kit/assets/og-image.png copyright: Copyright © 2026 Emre Dursun diff --git a/package.json b/package.json index 34322f4..73003d6 100644 --- a/package.json +++ b/package.json @@ -32,12 +32,12 @@ "license": "MIT", "repository": { "type": "git", - "url": "git+https://github.com/besync-labs/antigravity-ai-kit.git" + "url": "git+https://github.com/devran-ai/kit.git" }, "bugs": { - "url": "https://github.com/besync-labs/antigravity-ai-kit/issues" + "url": "https://github.com/devran-ai/kit/issues" }, - "homepage": "https://github.com/besync-labs/antigravity-ai-kit#readme", + "homepage": "https://github.com/devran-ai/kit#readme", "engines": { "node": ">=18.0.0", "npm": ">=9.0.0" From 43a4f6ba28562a4443bd5bd5a3208fc19c165c04 Mon Sep 17 00:00:00 2001 From: emredursun Date: Sun, 22 Mar 2026 16:09:28 +0100 Subject: [PATCH 3/3] fix: address gemini-code-assist review findings on PR #1 - Fix HIGH: docs/getting-started.md cp command references old dir name - Fix MEDIUM: git-workflow.md hotfix merge instruction clarified - Fix MEDIUM: CONTRIBUTING.md restore skill/workflow frontmatter examples --- .agent/rules/git-workflow.md | 2 +- CONTRIBUTING.md | 20 ++++++++++++++++++-- docs/getting-started.md | 2 +- 3 files changed, 20 insertions(+), 4 deletions(-) diff --git a/.agent/rules/git-workflow.md b/.agent/rules/git-workflow.md index 38fe1b9..223da98 100644 --- a/.agent/rules/git-workflow.md +++ b/.agent/rules/git-workflow.md @@ -79,7 +79,7 @@ Examples: 1. Create `hotfix/*` branch from `main` 2. Fix the issue with minimal changes 3. Create PR targeting `main` -4. After merge, cherry-pick or merge `main` into `dev` +4. After merge, merge `main` back into `dev` to sync the hotfix --- diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1badd31..631f995 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -116,14 +116,30 @@ Before submitting a PR, ensure: ### Adding a Skill -1. Create `.agent/skills/your-skill/SKILL.md` with frontmatter +1. Create `.agent/skills/your-skill/SKILL.md` with frontmatter: + ```markdown + --- + name: your-skill + description: What this skill does + triggers: [keyword1, keyword2] + --- + # Your Skill + ## Overview + ... + ``` 2. Add entry to `.agent/manifest.json` 3. Update counts everywhere (see Adding an Agent, step 3) 4. Run `npm test` ### Adding a Workflow -1. Create `.agent/workflows/your-workflow.md` with frontmatter +1. Create `.agent/workflows/your-workflow.md` with frontmatter: + ```markdown + --- + description: What this workflow does + --- + # Steps... + ``` 2. Add entry to `.agent/manifest.json` 3. Update counts 4. Run `npm test` diff --git a/docs/getting-started.md b/docs/getting-started.md index 73c4531..f0a3a2f 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -38,7 +38,7 @@ ag-kit update --dry-run # Preview changes without applying git clone https://github.com/devran-ai/kit.git # 2. Copy .agent/ to your project -cp -r antigravity-ai-kit/.agent/ your-project/.agent/ +cp -r kit/.agent/ your-project/.agent/ # 3. Start your session /status