Neura Market
Back to .md Directory
GEMINI.md

Totem — Development Rules

Defines team-wide conventions for a pnpm monorepo: branch strategy, commit rules, tooling, and a mandatory knowledge-search workflow before coding.

mmnto-ai
May 2, 2026
0 downloads
4 views
ai prompt gemini workflow
View source

What this file does

Defines team-wide conventions for a pnpm monorepo: branch strategy, commit rules, tooling, and a mandatory knowledge-search workflow before coding.

When to use it

  • Starting a new TypeScript monorepo with pnpm and strict linting
  • Adopting a knowledge-first development workflow with search before code
  • Setting up protected main branch and PR conventions for a team
  • Enforcing a no-secrets-in-config policy across a project

Assumes this stack

pnpmTypeScriptGit BashWindows 11ZodChangesets

Totem — Development Rules

Essentials

  • pnpm only (never npm/yarn). Use pnpm dlx (never npx). Windows 11 + Git Bash. TypeScript strict mode.
  • main is protected. Feature branches + PRs. Never amend commits on feature branches.
  • Use Closes #NNN in PR descriptions.
  • kebab-case.ts files, err (never error) in catch blocks, no empty catches.
  • Run pnpm run format before committing.
  • NEVER put secrets in config files. .env only.

Totem Workflow (BLOCKING)

  • Before writing code: call search_knowledge with what you're changing
  • Before planning/architecture: query totem-strategy:search_knowledge for ADRs
  • After merging a PR: run totem extract <pr> --yes, then totem docs if releasing
  • NEVER use git push --no-verify. Fix the violation or file a ticket.

Contributor Principles

<!-- totem-ignore-next-line -->
  • Update AI_PROMPT_BLOCK in init.ts when changing reflexes/hooks/prompts.
<!-- totem-ignore-next-line -->
  • GCA decline: add lesson with review-guidance tag + update .gemini/styleguide.md §6.
  • No totem-ignore, eslint-disable, or --no-verify without a ticket.
  • GCA replies: ONE @gemini-code-assist comment per PR.

Detailed Rules

  • See .gemini/styleguide.md for full code style, naming, and architecture rules.
  • Changesets: write .changeset/ files manually. Use pnpm run version (never bare pnpm version).
  • Named constants for magic numbers. Zod at system boundaries only.

What's inside

5 sections: Essentials, Totem Workflow, Contributor Principles, Detailed Rules, and a styleguide reference

Change this for your project

  • Replace Totem references with your own project name
  • Replace search_knowledge and totem-strategy:search_knowledge with your own knowledge-base commands
  • Replace totem extract and totem docs with your own post-merge automation
  • Replace .gemini/styleguide.md path with your own styleguide location

Where it goes

Keep it in your repository where the agent or team that needs it will read it.

Related Documents

GEMINI.md

MechCAD-MLLM

Proposes a MLLM + dual-decoder architecture for mechanical CAD generation, combining Drawing2CAD and CAD-GPT ideas.

aillmeval
0
3
WHT222
GEMINI.md

Prompt Generator

Generates Stable Diffusion and Flux prompts via Qwen3-8B on Ollama, with a Gradio UI and CLI.

aipromptsafety
0
3
Limbicnation
GEMINI.md

Agent Instructions

Defines a three-layer architecture (directive, orchestration, execution) for AI agents that self-anneal errors and update living SOPs.

aiagent
0
2
mitchelldschafer