Skip to content

chore(standards): synced file(s) with hallelx2/dev-standards#1

Open
hallelx2 wants to merge 10 commits into
mainfrom
repo-sync/dev-standards/default
Open

chore(standards): synced file(s) with hallelx2/dev-standards#1
hallelx2 wants to merge 10 commits into
mainfrom
repo-sync/dev-standards/default

Conversation

@hallelx2

@hallelx2 hallelx2 commented Jun 13, 2026

Copy link
Copy Markdown
Owner

synced local file(s) with hallelx2/dev-standards.

Changed files
  • created local AGENTS.md from remote AGENTS.md
  • created local .github/copilot-instructions.md from remote .github/copilot-instructions.md
  • created local directory .github/agents/ and copied all sub files/folders from remote directory .github/agents/
  • created local .github/instructions/backend.instructions.md from remote .github/instructions/backend.instructions.md
  • created local .github/instructions/frontend.instructions.md from remote .github/instructions/frontend.instructions.md
  • created local .github/instructions/security.instructions.md from remote .github/instructions/security.instructions.md
  • created local .github/workflows/security.yml from remote .github/workflows/security.yml
  • created local .github/workflows/security.reusable.yml from remote .github/workflows/security.reusable.yml
  • created local .github/workflows/jules-review.yml from remote .github/workflows/jules-review.yml
  • created local .github/dependabot.yml from remote .github/dependabot.yml

This PR was created automatically by the repo-file-sync-action workflow run #27949902439

Copilot AI review requested due to automatic review settings June 13, 2026 02:11
@vercel

vercel Bot commented Jun 13, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
vectorless-dashboard Error Error Jun 22, 2026 11:42am
vectorless-web Ready Ready Preview, Comment Jun 22, 2026 11:42am

@sourcery-ai

sourcery-ai Bot commented Jun 13, 2026

Copy link
Copy Markdown

Reviewer's Guide

Syncs dev-standards AI agent guidelines and security workflows into this repo, adding AGENTS/agent instruction docs, Copilot review guidance, path-scoped review instructions, and reusable GitHub Actions for security scanning and optional Jules security reviews on PRs.

File-Level Changes

Change Details Files
Introduce shared AI agent brief and review standards for the repo.
  • Add AGENTS.md as the central brief for all AI agents interacting with the codebase, defining workflow expectations, review bar, and language-specific conventions.
  • Document Vectorless-specific security requirements, especially BYOK handling and multi-tenant isolation, to guide future changes and reviews.
AGENTS.md
Configure Copilot baseline review behavior for PRs in this repo.
  • Define Copilot review rubric emphasizing acceptance-criteria alignment, correctness, edge cases, and security priorities like multi-tenant isolation and secrets handling.
  • Clarify expectation of concrete findings with file:line references and preference for fewer high-confidence issues.
.github/copilot-instructions.md
Add reusable security scanning workflow and caller workflow for consistent CI security checks.
  • Create reusable security.reusable.yml workflow running gitleaks for secrets, Trivy for vuln/misconfig/secret scanning, and conditional gosec SAST when Go modules are present.
  • Add top-level security.yml workflow that runs on PRs and main-branch pushes and delegates to the reusable workflow with inherited secrets.
.github/workflows/security.reusable.yml
.github/workflows/security.yml
Enable optional automated Jules-based security reviews on PRs.
  • Add jules-review.yml workflow that triggers on PR events and conditionally invokes the Jules PR reviewer action when JULES_API_KEY is configured.
  • Configure the Jules review prompt to follow the security-reviewer agent rubric, focusing on authorization, multi-tenant leakage, BYOK, injection/SSRF, and crypto weaknesses.
.github/workflows/jules-review.yml
Define specialized AI reviewer agents for backend, frontend, security, and test reliability.
  • Add backend-reviewer agent spec focused on Go correctness, concurrency, error handling, API contracts, and data-layer practices.
  • Add frontend-reviewer agent spec focused on TypeScript/Next.js boundaries, XSS, accessibility, performance, and brand consistency.
  • Add security-reviewer agent spec tuned for adversarial appsec review covering authZ, BYOK, injection/SSRF, crypto, and dependencies with severity ranking.
  • Add test-reliability-reviewer agent spec to assess whether tests prove behavior, cover edge cases, remain deterministic, and ensure reliability.
.github/agents/backend-reviewer.agent.md
.github/agents/frontend-reviewer.agent.md
.github/agents/security-reviewer.agent.md
.github/agents/test-reliability-reviewer.agent.md
Set up path-scoped review instructions to steer AI/code-review behavior by file type.
  • Add backend.instructions.md applying Go backend review rubric (errors, concurrency, context, resources, queries, tests) to all .go files.
  • Add frontend.instructions.md applying TypeScript/Next.js review rubric (boundaries, XSS, types, a11y, performance, brand) to TS/TSX/CSS files.
  • Add security.instructions.md applying security review rubric to all files in the repo, emphasizing authZ, secrets, injection/SSRF, crypto, and dependency risk.
.github/instructions/backend.instructions.md
.github/instructions/frontend.instructions.md
.github/instructions/security.instructions.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@coderabbitai

coderabbitai Bot commented Jun 13, 2026

Copy link
Copy Markdown

Warning

Review limit reached

@hallelx2, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 59 minutes and 43 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 5f0a8fe1-5ecd-4f71-9de2-fbd04e75832e

📥 Commits

Reviewing files that changed from the base of the PR and between 08af764 and 3b24fc2.

📒 Files selected for processing (13)
  • .github/agents/backend-reviewer.agent.md
  • .github/agents/frontend-reviewer.agent.md
  • .github/agents/security-reviewer.agent.md
  • .github/agents/test-reliability-reviewer.agent.md
  • .github/copilot-instructions.md
  • .github/dependabot.yml
  • .github/instructions/backend.instructions.md
  • .github/instructions/frontend.instructions.md
  • .github/instructions/security.instructions.md
  • .github/workflows/jules-review.yml
  • .github/workflows/security.reusable.yml
  • .github/workflows/security.yml
  • AGENTS.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch repo-sync/dev-standards/default

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey - I've reviewed your changes and they look great!


Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR syncs shared engineering/AI-review standards and standardized security automation workflows from hallelx2/dev-standards into this repository, establishing consistent reviewer guidance and baseline security scanning across repos.

Changes:

  • Adds AGENTS.md plus Copilot/agent reviewer definitions to standardize automated review behavior.
  • Introduces path-scoped backend/frontend/security instruction files under .github/instructions/.
  • Adds security scanning workflows (gitleaks, Trivy, gosec) and an optional Jules-based PR security review workflow.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
AGENTS.md Adds repo-wide engineering and review standards for human + AI agents.
.github/copilot-instructions.md Defines baseline Copilot PR review rubric and priorities.
.github/agents/backend-reviewer.agent.md Adds Go-focused reviewer role definition.
.github/agents/frontend-reviewer.agent.md Adds TS/Next-focused reviewer role definition.
.github/agents/security-reviewer.agent.md Adds adversarial security reviewer role definition.
.github/agents/test-reliability-reviewer.agent.md Adds test quality/determinism reviewer role definition.
.github/instructions/backend.instructions.md Applies Go review rubric to **/*.go.
.github/instructions/frontend.instructions.md Applies frontend review rubric to TS/TSX/CSS files.
.github/instructions/security.instructions.md Applies security review rubric to all changed files.
.github/workflows/security.yml Adds caller workflow to run standardized security scanning on PRs and main.
.github/workflows/security.reusable.yml Adds reusable workflow implementing gitleaks/Trivy/gosec scanners.
.github/workflows/jules-review.yml Adds optional automated Jules PR security review workflow.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +12 to +22
permissions:
contents: read
pull-requests: read
security-events: write

jobs:
security:
# Local reference — the reusable file is synced into THIS repo too, so each repo
# is self-contained and this works whether dev-standards is public or private.
uses: ./.github/workflows/security.reusable.yml
secrets: inherit
Comment on lines +10 to +13
permissions:
contents: read
pull-requests: read
security-events: write
Comment on lines +52 to +56
- name: gosec
if: steps.detect.outputs.is_go == 'true'
uses: securego/gosec@master
with:
args: -no-fail -fmt text ./...
Comment on lines +21 to +29
- name: Guard — only run when a Jules key is configured
id: guard
run: |
if [ -n "${{ secrets.JULES_API_KEY }}" ]; then
echo "enabled=true" >> "$GITHUB_OUTPUT"
else
echo "enabled=false" >> "$GITHUB_OUTPUT"
echo "No JULES_API_KEY set — skipping automated Jules review. Use @jules on the PR instead."
fi
Comment on lines +30 to +35
- name: Jules security review
if: steps.guard.outputs.enabled == 'true'
uses: sanjay3290/jules-pr-reviewer@main
with:
jules-api-key: ${{ secrets.JULES_API_KEY }}
github-token: ${{ github.token }}
@github-advanced-security

Copy link
Copy Markdown

You are seeing this message because GitHub Code Scanning has recently been set up for this repository, or this pull request contains the workflow file for the Code Scanning tool.

What Enabling Code Scanning Means:

  • The 'Security' tab will display more code scanning analysis results (e.g., for the default branch).
  • Depending on your configuration and choice of analysis tool, future pull requests will be annotated with code scanning analysis results.
  • You will be able to see the analysis results for the pull request's branch on this overview once the scans have completed and the checks have passed.

For more information about GitHub Code Scanning, check out the documentation.

@hallelx2 hallelx2 force-pushed the repo-sync/dev-standards/default branch from 0da8c86 to 6c99d8b Compare June 13, 2026 02:47
@hallelx2 hallelx2 force-pushed the repo-sync/dev-standards/default branch from 6c99d8b to 8254034 Compare June 13, 2026 02:49
@hallelx2 hallelx2 force-pushed the repo-sync/dev-standards/default branch from 8254034 to 2cdacaa Compare June 13, 2026 07:33
@hallelx2 hallelx2 force-pushed the repo-sync/dev-standards/default branch from 2cdacaa to abb9ef0 Compare June 13, 2026 08:04
@hallelx2 hallelx2 force-pushed the repo-sync/dev-standards/default branch from abb9ef0 to fbcb471 Compare June 15, 2026 11:50
hallelx2 added a commit that referenced this pull request Jun 20, 2026
* HAL-87: scaffold Vectorless docs site (Fumadocs)

Brand-matched Fumadocs (Next.js App Router) documentation site for
docs.vectorless.store.

- Dark theme primary; Geist Sans + Geist Mono + Instrument Serif display
- Blue->pink brand gradient and subtle grid background texture
- Branded landing page (hero, feature grid, quickstart strip)
- Sections: Getting Started, Core Concepts (tree retrieval, no-chunking,
  treewalk, citations), API Reference (placeholder), SDKs (TS/Python/Go),
  Self-hosting (Neon + R2 + QStash + Docker, placeholder)
- Orama search, OG images, llms.txt
- Uses canonical 'treewalk' strategy name (retired 'pageindex')

* Redesign docs site to the LIGHT Vectorless brand (HAL-190)

The Fumadocs site was wrongly built dark-first with a full-page grid
wash and aura/glow pseudo-elements. Restyle it to match the brand
visual identity in vectorless-why/DESIGN.md, which is LIGHT.

- Default theme -> light (RootProvider defaultTheme: 'light').
- Light is now the primary, clean canvas: #FCFCFD, ink #0A0A0A,
  secondary #3F3F46, muted #71717A, hairlines #E5E7EB.
- Remove the heavy body::before grid wash and body::after aura glow.
  Content/docs pages are clean near-white with whitespace.
- Reintroduce only a very faint brand grid rgba(20,86,240,0.06) on the
  landing hero, masked to fade out (.vl-hero-grid).
- Keep the blue->pink signal gradient on exactly one hero line; drop the
  second serif/gradient register on the pull quote (now plain light sans
  with a mono eyebrow caption).
- Mono eyebrows at 0.16em tracking; body weight ~300 per DESIGN.md.
- Quickstart block is now a real dark inset terminal (#0A0A0A) — the one
  place dark is allowed.
- Dark theme retained as an optional toggle, not the default.

Restyle only: nav, sidebar, search, section structure and content
unchanged. pnpm build passes.

* Redesign docs site to the LIGHT Vectorless brand (HAL-190) (#1)

The Fumadocs site was wrongly built dark-first with a full-page grid
wash and aura/glow pseudo-elements. Restyle it to match the brand
visual identity in vectorless-why/DESIGN.md, which is LIGHT.

- Default theme -> light (RootProvider defaultTheme: 'light').
- Light is now the primary, clean canvas: #FCFCFD, ink #0A0A0A,
  secondary #3F3F46, muted #71717A, hairlines #E5E7EB.
- Remove the heavy body::before grid wash and body::after aura glow.
  Content/docs pages are clean near-white with whitespace.
- Reintroduce only a very faint brand grid rgba(20,86,240,0.06) on the
  landing hero, masked to fade out (.vl-hero-grid).
- Keep the blue->pink signal gradient on exactly one hero line; drop the
  second serif/gradient register on the pull quote (now plain light sans
  with a mono eyebrow caption).
- Mono eyebrows at 0.16em tracking; body weight ~300 per DESIGN.md.
- Quickstart block is now a real dark inset terminal (#0A0A0A) — the one
  place dark is allowed.
- Dark theme retained as an optional toggle, not the default.

Restyle only: nav, sidebar, search, section structure and content
unchanged. pnpm build passes.

* docs: use the real Vectorless V logo in nav + favicon (HAL-191)

Replace the invented node-graph mark with the canonical logo — blue tile +
white V (M4 4 L12 20 L20 4) + pink focal dot — matching vectorless-dashboard's
icon.tsx; add the matching app favicon. Wordmark in Geist medium.

Closes HAL-191.

* docs: use the real Vectorless V logo in nav + favicon (HAL-191) (#2)

Replace the invented node-graph mark with the canonical logo — blue tile +
white V (M4 4 L12 20 L20 4) + pink focal dot — matching vectorless-dashboard's
icon.tsx; add the matching app favicon. Wordmark in Geist medium.

Closes HAL-191.

* Polish docs home page design

Elevate the marketing/home surface within the Vectorless light brand:
- Hero: real V mark, staggered precision reveal, refined terminal inset
- New document -> tree -> cited answer SVG motif (hairline, blue path, single pink citation dot; edges draw + nodes snap)
- Feature grid with mono index numbers and hover accent
- Parse/Walk/Cite three-step band
- Refined Instrument-Serif thesis closer with CTA

No new gradients, no dark page bg, no new mark - honors DESIGN.md.

* feat(docs): premium landing page redesign with GSAP and HeroShader

* style(docs): mintlify-inspired redesign and hero button fix

* chore(docs): redirect primary GitHub links to vectorless-engine

* fix(docs): resolve hero stacking and button visibility issues

* style(docs): fix code block contrast and remove card blue border

* chore: remove deprecated packages ts-sdk, openapi, and mcp-tools

* feat: migrate docs and blogs to monorepo and update branding

* style: premium editorial layout redesign for vectorless blog

* style: expand layout to full-width page

* ci: update workflows to match monorepo package configuration

* fix: resolve workspace react type conflicts by overriding react and react types

* chore: add typecheck scripts for all monorepo apps to run under turborepo

* fix: resolve lint errors and warnings across workspace packages
hallelx2 added 2 commits June 22, 2026 11:39
Synced AI-review standards from hallelx2/dev-standards.
…m remote '.github/copilot-instructions.md'

Synced AI-review standards from hallelx2/dev-standards.
hallelx2 added 8 commits June 22, 2026 11:39
…b/agents/'

Synced AI-review standards from hallelx2/dev-standards.
…tions.md' from remote '.github/instructions/backend.instructions.md'

Synced AI-review standards from hallelx2/dev-standards.
…ctions.md' from remote '.github/instructions/frontend.instructions.md'

Synced AI-review standards from hallelx2/dev-standards.
…ctions.md' from remote '.github/instructions/security.instructions.md'

Synced AI-review standards from hallelx2/dev-standards.
… remote '.github/workflows/security.yml'

Synced AI-review standards from hallelx2/dev-standards.
…yml' from remote '.github/workflows/security.reusable.yml'

Synced AI-review standards from hallelx2/dev-standards.
…from remote '.github/workflows/jules-review.yml'

Synced AI-review standards from hallelx2/dev-standards.
…'.github/dependabot.yml'

Synced AI-review standards from hallelx2/dev-standards.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants