Home / vmobifystudio / app-dev-team · skills/brownfield-onboarding/SKILL.md · GitHub

brownfield-onboarding skillA

brownfield-onboarding is agent-read markdown (skill) from vmobifystudio/app-dev-team: Use when pointing the team at an EXISTING, already-built app instead of a blank project — detects the stack, reverse-engineers the as-built architecture, and classifies remediation work as safe-to-auto-fix vs risky-needs-approval. Triggered by /app-onboard, /app-audit, and by /app-run when it detects a non-empty app directory..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Brownfield onboarding

Greenfield commands generate vision → PRD → architecture → code. For an app that already exists,
you go the other way: **read the code, snapshot what's there, grade it against the House KB, and
plan the gap.** This skill is the procedure for the "read and understand" half.

## When to use

- `/app-onboard` (adopt an existing codebase) and `/app-audit` (grade it) both start here.
- `/app-run` invokes this when the target directory already contains an app (see Detection).

## Step 1 — Detect the app

Scan the target directory (not deeper than ~3 levels) to establish ground truth before any agent reasons about it:

- **iOS:** `*.xcodeproj` / `*.xcworkspace` / `Package.swift`; read `project.yml` (XcodeGen),
  `*.xcconfig`, `Info.plist`, `Package.resolved`. Note Swift version, min iOS target, SwiftUI vs UIKit.
- **Android:** `settings.gradle*`, `app/build.gradle(.kts)`, `gradle/libs.versions.toml`. Note Kotlin/AGP,
  `compileSdk`/`minSdk`/`targetSdk`, Compose vs XML, the module list.
- **Both / signals:** existing `CLAUDE.md`, `README`, `docs/`, CI under `.github/workflows`,
…

Read the whole file at its exact version.

How to install

Latest version
mdr add vmobifystudio/app-dev-team/brownfield-onboarding@git:20260729.d5165d9
Exact content
mdr add vmobifystudio/app-dev-team/brownfield-onboarding@sha256:178c20f085e7879a

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_nnen54bpn7mjnl5n.svg)](https://markdownregistry.com/a/art_nnen54bpn7mjnl5n)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260729.d5165d9 latest2026-07-29 d5165d9 4,855 BA view · diff
git:20260601.6191cd62026-06-01 6191cd6 4,366 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4855 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

vmobifystudio/app-dev-team · 4 stars · license MIT · pushed 2026-09-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_nnen54bpn7mjnl5n
GET https://markdownregistry.com/api/v1/resolve?ref=vmobifystudio/app-dev-team/brownfield-onboarding
GET https://markdownregistry.com/api/v1/blob/178c20f085e7879a260d754d0b2d9b1a7c884fb31f04a77554bba957ef81e78b

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from vmobifystudio/app-dev-team

accessibility-gate skill
vmobifystudio/app-dev-team · skills/accessibility-gate/SKILL.md · Use as a pass/fail gate on any diff with a user-facing surface — by code-reviewer during review, by qa-engineer during…
git:20260729.071181e · audit A · 4 stars
agent-isolation skill
vmobifystudio/app-dev-team · skills/agent-isolation/SKILL.md · Use before spawning any agent that writes files, and by every developer/fixer agent as its first and last action. Gives…
git:20260807.98058c3 · audit A · 4 stars
architecture-builder skill
vmobifystudio/app-dev-team · skills/architecture-builder/SKILL.md · Use to produce the technical architecture doc and engineering principles for a mobile app. Used primarily by the CTO…
git:20260729.6f1f11e · audit A · 4 stars
board-doctor skill
vmobifystudio/app-dev-team · skills/board-doctor/SKILL.md · Use to validate docs/31-board.md before spawning any agent, and to verify a developer's "DONE" claim before moving a…
git:20260729.071181e · audit A · 4 stars
business-model skill
vmobifystudio/app-dev-team · skills/business-model/SKILL.md · Use when deciding or revisiting how the product makes money — pricing, tiers, trial shape, ad load, unit economics — by…
git:20260729.071181e · audit A · 4 stars
content-design skill
vmobifystudio/app-dev-team · skills/content-design/SKILL.md · Use when writing or reviewing any string a user reads — labels, buttons, empty states, errors, permission prompts…
git:20260729.071181e · audit A · 4 stars
context-preflight skill
vmobifystudio/app-dev-team · skills/context-preflight/SKILL.md · Run before changing a repository to verify branch, worktree, ticket, dependencies, source-of-truth documents, and…
git:20260731.42d47b3 · audit A · 4 stars
database-migration skill
vmobifystudio/app-dev-team · skills/database-migration/SKILL.md · Use before changing any persisted schema — by backend-developer on a server store, by web-developer on a client or…
git:20260729.071181e · audit A · 4 stars
defect-hunting skill
vmobifystudio/app-dev-team · skills/defect-hunting/SKILL.md · Use when reviewing code, auditing an app, writing a guard rule or test, or certifying any threshold/constant/formula…
git:20260810.958b327 · audit A · 4 stars
dependency-policy skill
vmobifystudio/app-dev-team · skills/dependency-policy/SKILL.md · Audit declared dependencies, lockfiles, tool versions, compatibility, licenses, and upgrade evidence before…
git:20260731.42d47b3 · audit A · 4 stars
design-system skill
vmobifystudio/app-dev-team · skills/design-system/SKILL.md · Use when defining or extending design tokens and the shared component library — by product-designer when writing…
git:20260729.071181e · audit A · 4 stars
git-pr-strategy skill
vmobifystudio/app-dev-team · skills/git-pr-strategy/SKILL.md · Apply safe branching, commits, conflict resolution, review ownership, merge, rollback, and release-tag rules.
git:20260731.42d47b3 · audit A · 4 stars

Every file in vmobifystudio/app-dev-team

Browse by kind, by grade A, or by owner.