Skip to content

Add a lot to skills and got the skill writer agent working and api agent working#2

Merged
zazzcode merged 10 commits intomainfrom
try2-agent-interaction
Mar 5, 2026
Merged

Add a lot to skills and got the skill writer agent working and api agent working#2
zazzcode merged 10 commits intomainfrom
try2-agent-interaction

Conversation

@zazzcode
Copy link
Copy Markdown
Owner

@zazzcode zazzcode commented Mar 5, 2026

this is the first iteration

- CONTRIBUTOR_SETUP: dev DB only in Docker; API/client in separate terminals
  for visible logs and hot reload; port 5433 note; db:push not db:migrate;
  pre-v1 workflow; link to data-architecture
- Replace database.md with data-architecture.md: schema-first philosophy,
  snake_case→camelCase conversion, pre-v1 vs v1 workflow, key tables
- AGENTS.md: pre-v1 push workflow wording
- architecture.md: link to data-architecture standard
- ZAZZ-FRAMEWORK.md: update example to data-architecture.md

Made-with: Cursor
- Replace architecture.md with system-architecture.md: JS-only stack, AJV (not Zod),
  Mantine, @xyflow/react, optional cloud deployment (S3/GCS)
- Remove unused zod dependency from api
- Regenerate package-lock.json

Made-with: Cursor
- coding-styles: UPPER_SNAKE_CASE for status codes, i18n pattern
- data-architecture: UPPER_SNAKE_CASE in DB, link to schema
- Merge languages.md into system-architecture (Node 22+, ESM)
- testing: PactumJS focus, real DB, TDD standards, bullet format
- Add .github/workflows/test.yml: run tests on PR/push to main
- ZAZZ-FRAMEWORK: remove languages.md from example

Made-with: Cursor
…ing instructions

- Expand SKILL.md: self-contained problem statement, standards discussion, AC/DoD,
  agent constraints (Always/Ask first/Never), decomposition, evaluation
- Add interview techniques from SDD best practices (MoSCoW, INVEST, EARS, etc.)
- Add deliverable sizing: single deliverable < 8-hour agent day
- Add development mode: focus on improving skill; agent may edit SKILL.md
- Add generation triggers: 'generate the spec', 'create a draft', etc.
- Add Zazz Board API integration (dedFilePath sync) when not in dev mode
- Add YAML frontmatter for Cursor/Claude/Warp discovery
- Add README: user guide, key phrases, workflow, dev mode
- Add loading instructions for Cursor, Claude Code, and Warp

Made-with: Cursor
- SKILL.md: Add SPEC file location/naming section; restructure header (H1, Overview, Role, etc.); fix lead-paragraph styling
- multiple-agent-tokens-feature-SPEC.md: Full spec with AC verification, cache add/remove behavior, :id/:code route support, project access model, non-project routes punt
- future-fixes.md: Non-project routes design, project-level access, multi-instance cache

Made-with: Cursor
- Add before-creating checklists for deliverable and task
- Add Missing data / do not invent rule with example
- Move Auth and Env to top; remove redundancy
- Trim Key conventions; simplify Fetch spec

Made-with: Cursor
- spec-builder-agent: SPEC naming {deliverableCode}-{slug}-SPEC.md, first 5 words,
  hyphen-delimited, index.yaml update, do not invent data
- ZAZZ-5: fix-routes-no-project SPEC (image routes project filtering)
- ZAZZ-6: multiple-agent-tokens-feature deliverable, rename spec to ZAZZ-6 prefix
- index.yaml: add ZAZZ-5, ZAZZ-6
- future-fixes: minor updates

Made-with: Cursor
…roject-scoped pattern

- coding-styles: API validation vs business logic; schema org; project-scoped handler
  pattern; business error mapping; file org (why: parallel work when agents lock files)
- system-architecture: link to coding-styles validation section
- testing: document openapi.test.mjs

Made-with: Cursor
…-board-api PROJECT_CODE → ZAZZ_PROJECT_CODE

Made-with: Cursor
@zazzcode zazzcode merged commit 2c3f152 into main Mar 5, 2026
@zazzcode zazzcode deleted the try2-agent-interaction branch March 7, 2026 21:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants