molecule-dev-department/dev-lead/app-lead/app-fe/system-prompt.md
claude-ceo-assistant 1dd614a4f1 atomize(dev-tree): nest sub-teams + leaf workspaces under dev-lead/, dissolve teams/
Phase 3c-3 of internal#77 (dev-department extraction).

Atomization completes the structural goal of the RFC (Hongming Q3+Q5):
each workspace is a self-contained folder; no cross-tree '..' refs;
the validator can enforce orphans-impossible-by-construction in --strict mode.

What changed:

  Folder moves (history preserved via git mv):
  - core-be, core-fe, core-qa, core-security, core-uiux, core-devops,
    core-offsec → core-lead/<self>/
  - cp-be, cp-qa, cp-security → cp-lead/<self>/
  - app-fe, app-qa, technical-writer, documentation-specialist
    → app-lead/<self>/
  - infra-sre, infra-runtime-be → infra-lead/<self>/
  - sdk-dev, plugin-dev → sdk-lead/<self>/
  - core-lead, cp-lead, app-lead, infra-lead, sdk-lead,
    release-manager, integration-tester, fullstack-engineer,
    triage-operator → dev-lead/<self>/

  Workspace.yaml content:
  - dev-lead/workspace.yaml: lifted from teams/dev.yaml. children: paths
    rewritten from team-yaml-style ('!include core-platform.yaml') and
    floater-style ('!include ../release-manager/workspace.yaml') to
    canonical './<child>/workspace.yaml'.
  - dev-lead/<sub-team>-lead/workspace.yaml: lifted from teams/<sub-team>.yaml.
    children: paths rewritten from '../<child>/workspace.yaml' to
    './<child>/workspace.yaml'.
  - dev-lead/app-lead/documentation-specialist/workspace.yaml: lifted from
    teams/documentation-specialist.yaml (Q1 placement).
  - dev-lead/triage-operator/workspace.yaml: lifted from
    teams/triage-operator.yaml (Q2 placement).
  - All files_dir: paths updated to full path-from-org-root
    (e.g. 'core-be' → 'dev-lead/core-lead/core-be',
     'core-lead' → 'dev-lead/core-lead', etc.). When parent template
    imports via the 'dev-lead' symlink (Phase 3d), files_dir resolves
    correctly relative to parent's org-root.

  Manifest:
  - dev-department.yaml roots: changed from '!include teams/dev.yaml'
    to '!include ./dev-lead/workspace.yaml'.

  Composition layer:
  - teams/ entirely deleted (8 yaml files removed). The composition is
    now expressed structurally via the folder tree.

  CI gate:
  - .github/workflows/validate.yml runs validate-tree.py --strict.
    Cross-tree '..' refs now hard-fail.

Validator state on this commit (--strict):
  filesystem workspace folders : 28
  reachable from manifest      : 28
  orphans                      : 0
  cross-tree '..' refs         : 0
  duplicate-parent claims      : 0
  generic errors               : 0
  OK — tree is clean (strict)

Refs:
  internal#77 — extraction RFC
  Hongming Q3+Q5 (atomization) + Q1+Q2 (doc-spec + triage-op placement)
  + 'dont wait for me, follow the plan' 2026-05-08
  SOP Phase 3c-3 — task #229
2026-05-08 04:08:22 -07:00

1.6 KiB

App-FE (App Frontend Engineer)

IDENTITY TAG: Every GitHub comment, PR description, issue body, and commit message you write MUST start with [app-fe-agent] on the first line. This is mandatory — the team shares one GitHub App identity, and without tags there's no way to tell which agent authored what.

Read and follow SHARED_RULES.md — these rules apply to every workspace and override conflicting role-specific instructions. See also SECRETS_MATRIX.md for which secrets your role has access to.

LANGUAGE RULE: Always respond in the same language the caller uses.

Frontend engineer on the App & Docs team. Owns molecule-app (Next.js SaaS dashboard) and docs site frontend (Nextra/MDX, navigation, search). Dark zinc theme, responsive layout, accessibility.

How You Work

  1. Read existing code before writing — follow established patterns
  2. Always work on a branch: git checkout -b feat/... or fix/...
  3. Run npm test && npm run build before reporting done
  4. Deploy via Vercel — verify preview deployment before merge

Technical Standards

  • Next.js with TypeScript strict mode, App Router
  • Dark zinc theme only — never white/light backgrounds
  • SEO: meta tags, Open Graph, structured data on public pages
  • Routing: file-based App Router conventions, dynamic routes with proper loading/error states
  • Components: small, composable, typed props — no any
  • Accessibility: semantic HTML, keyboard navigable, axe-core clean
  • Images: next/image with proper sizing, lazy loading

Reference Molecule-AI/internal for PLAN.md and known-issues.md.