Skip to content

chore: adopt coding standards and agent skills, drop Median - #201

Open
github-actions[bot] wants to merge 4 commits into
mainfrom
chore/agent-conventions
Open

chore: adopt coding standards and agent skills, drop Median#201
github-actions[bot] wants to merge 4 commits into
mainfrom
chore/agent-conventions

Conversation

@github-actions

@github-actions github-actions Bot commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Opened automatically when chore/agent-conventions was pushed.

The title is written from the diff and rewritten as you push, because this is squashed onto main and the title becomes the commit subject and the changelog line. Retitle it yourself and it is yours — the automation stops touching it.


Summary by cubic

Adds repo-wide coding standards and 15 pinned Matt Pocock skills, and replaces Median-based agent tracking with Linear team CRM. This updates agent guidance and configuration only; product runtime behavior is unchanged.

  • Makes CODING_STANDARDS.md the first read-first rule in AGENTS.md.
  • Documents the single-context domain model, root adrs/ layout, and five Linear triage labels.
  • Removes Median setup, task, commit, and PR guidance.
  • Documents that pr-title.yml rewrites invalid titles from the diff and drops issue IDs.
  • Adds the handoff and implement skills to the ask-matt routes.
  • Fixes the human-in-the-loop template's line endings and corrects the AGENTS.md Slack example, package list, and scope component description.

Written for commit eb5a0f1. Summary will update on new commits.

Review in cubic

CODING_STANDARDS.md becomes the first row of the AGENTS.md table, so it is
read before any code is written.

Fifteen mattpocock skills join the fourteen already tracked under
.agents/skills, and docs/agents/ records the per-repo configuration they
expect: issues live in Linear team CRM, the five canonical triage labels, and
a single-context domain model.

Median is gone. Issues are tracked in Linear, and the commit and pull request
conventions it documented were wrong for this repo anyway: pr-title.sh writes
PR titles from the diff and rejects a subject that does not start with a
conventional-commit type, so an issue id in the subject stops the automation.
@vercel

vercel Bot commented Sep 2, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated
crm-agent Ready Ready Preview Sep 2, 2026 8:28am UTC
crm-api Ready Ready Preview Sep 2, 2026 8:28am UTC
crm-app Ready Ready Preview Sep 2, 2026 8:28am UTC

Request Review

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

All reported issues were addressed across 57 files

Tip: instead of fixing issues one by one fix them all with cubic

Re-trigger cubic

Comment thread .agents/skills/diagnosing-bugs/scripts/hitl-loop.template.sh Outdated
Comment thread .agents/skills/diagnosing-bugs/scripts/hitl-loop.template.sh Outdated
Comment thread .agents/skills/improve-codebase-architecture/SKILL.md
Comment thread .agents/skills/teach/GLOSSARY-FORMAT.md
Comment thread .agents/skills/domain-modeling/ADR-FORMAT.md
Comment thread .agents/skills/setup-matt-pocock-skills/SKILL.md
Comment thread .agents/skills/setup-matt-pocock-skills/SKILL.md
Comment thread .agents/skills/writing-for-agents/SKILL-MECHANICS.md
Comment thread .agents/skills/triage/SKILL.md
Comment thread .agents/skills/setup-matt-pocock-skills/SKILL.md
docs/agents/domain.md named docs/adr/, which does not exist. The ADRs are in
adrs/ at the root, one file per topic and unnumbered, and an agent following the
old path missed every decision it was told not to relitigate. The doc now names
adrs/, says a skill naming docs/adr/ means adrs/, marks CONTEXT.md as not
written yet, cites adrs/i18n.md instead of an invented ADR-0007, and lists
typescript-config in the packages line. AGENTS.md's Domain docs entry follows.

pr-title.yml retitles a bad pull request title rather than stopping, so
"stops the automation" was wrong in both docs/agents/issue-tracker.md and
AGENTS.md. Both now say the check fails, the workflow writes a replacement from
the diff, and the id is thrown away. The rule is unchanged: no issue id in a
subject.

CODING_STANDARDS.md section 5 permitted a comment that explains why, which
contradicts AGENTS.md's absolute "never add code comments". AGENTS.md wins and
the two bullets collapse into one.

hitl-loop.template.sh was committed with CRLF, so its shebang read
"#!/usr/bin/env bash\r" and the template could not run on Linux or macOS. It is
LF now.

handoff and implement are two of the skills ask-matt routes to.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

All reported issues were addressed across 10 files (changes from recent commits).

Reply with feedback, questions, or to request a fix.

Fix all with cubic | Re-trigger cubic

Comment thread AGENTS.md Outdated
Comment thread docs/agents/domain.md Outdated
The example named scope-groups.tsx with a caption prop and a SCOPE_CAPTION
constant. None of those exist: the component is
apps/app/.../slack/slack-scope-groups.tsx, its props are title, groups and
withheld, and scope-groups.tsx only exists on feat/hubspot-connection. An agent
reading AGENTS.md went looking for a file that is not on main.

packages/email is not a package either. The directory holds a stale .turbo and
node_modules, no source and no package.json, and git tracks nothing in it. The
packages line drops it.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

All reported issues were addressed across 2 files (changes from recent commits).

Tip: Review your code locally with the cubic CLI to iterate faster.

Fix all with cubic | Re-trigger cubic

Comment thread AGENTS.md Outdated
Comment thread AGENTS.md
SlackScopeGroups hardcodes two strings, and one of them names Slack: "Broad
means the whole workspace, not one channel" and "Slack held this one back, so it
is off." The paragraph now says what is true instead — the component imports
@crm/ui and icons only, and the page owns the grouping and the withheld set.
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.

1 participant