agentleFS
rpraharajrpraharaj/ai-engineer/skills/start-project/SKILL.md

start-project

Skill1 starsChanged 15 days agoMITView on GitHub

Start a new project from an empty or near-empty directory using the stack the user named. Use when there is no existing app, or the user says new project, scaffold, greenfield, or from scratch. Do not invent a stack they did not choose. Do not run this inside a repo that already has a product.

9 other projects use a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

8 rules. 0 are common, 5 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 8 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  • could be automatic: a setting could enforce it
  1. Distinctive:

    Create the smallest runnable project the user asked for.

    line 12
  2. Very specific:

    Stop and use explore-codebase / implement-change if the workspace already has an application: a source tree with a manifest, lockfile, or …

    line 16
  3. Distinctive:

    If they asked to add an app inside a monorepo, stay in the package they named and match sibling packages.

    line 18
  4. Distinctive:

    Use the language, kind (app / lib / CLI / service), and tools the user named.

    line 22
  5. Very specific:

    If any of those are missing, ask one blocking question that lists the gaps.

    line 24
  6. Very specific:

    Prefer the official init for the named toolchain (cargo init, go mod init, dotnet new, language-native module init).

    line 26
  7. Distinctive:

    Do not commit secrets. Do not commit unless asked.

    line 38
  8. Distinctive:

    Run Install if needed, then Test, then Run as a one-shot if that is cheap.

    line 42

“Common” is measured: kept by at least 6 in 10 of the 8 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Start project

Create the smallest runnable project the user asked for. Do not pick a framework for them. Do not add a product feature beyond hello + the checks needed to prove it runs.

Is this the right skill?

Stop and use explore-codebase / implement-change if the workspace already has an application: a source tree with a manifest, lockfile, or more than bootstrap files (README, LICENSE, .gitignore, AGENTS.md).

If they asked to add an app inside a monorepo, stay in the package they named and match sibling packages.

Stack

Use the language, kind (app / lib / CLI / service), and tools the user named.

If any of those are missing, ask one blocking question that lists the gaps. Do not recommend a trendy stack. Do not run a third-party create-* scaffolder unless they named that exact tool.

Prefer the official init for the named toolchain (cargo init, go mod init, dotnet new, language-native module init). Match the package manager they named.

Create

  1. Init the project with that official tool (or a minimal manifest if no init exists).
  2. One entry point that runs.
  3. One test that fails if the entry is broken, in the runner that toolchain already uses.
  4. A root README with Install / Run / Test from commands you actually used. Preserve existing content; update only relevant sections. Do not run an initializer that overwrites existing files without first arranging a safe merge.
  5. If AGENTS.md exists, preserve its prose and update only the managed sections using explore-codebase Step 6. If absent, copy ../explore-codebase/references/agents-template.md, else ../../templates/AGENTS.md when available. If neither is readable, create only the repository facts and glossary, and report the missing defaults template. Fill facts from commands you ran. Never overwrite an existing instructions file with a starter template.

Load engineering-bar (paths in that skill). Climb Minimum path. No extra dependencies, no extra folders, no CI you were not asked for.

Do not commit secrets. Do not commit unless asked.

Prove

Run Install if needed, then Test, then Run as a one-shot if that is cheap. Keep the output. Unverified if you could not run them.

Done

  1. Stack and kind
  2. Files created
  3. Commands run and results
  4. Path of AGENTS.md / README

Next is write-prd if the product is still open, shape-work or implement-change for the first real feature — not a drive-by architecture.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.