kennethnwc

Agent-First Project Setup

Drop this file at ~/setup-agent-first.md. Pass to an AI coding agent via @~/setup-agent-first.md along with a project description. The agent will inspect the target repo, apply missing scaffolding, and leave the repo with a working doc infrastructure + enforcement.

How to use

Greenfield project: @~/setup-agent-first.md i want to start a project for <describe>. Set up the agent-first scaffolding first, before any product code.

Existing project: @~/setup-agent-first.md this repo already has some of this. Inspect current state, fill the gaps without overwriting what exists, report what you changed.

kennethnwc

Set Up Skills Infrastructure

Create a skills system for this project to help AI agents learn and retain project-specific knowledge.

Create this file:

skills/SKILLS.md

# Project Skills

kennethnwc

HOST_NAME=minima

source ~/.nvm/nvm.sh
nvm use stable
shopt -s autocd
shopt -s histappend

export PATH=$PATH:$HOME/bin

export HISTSIZE=5000

kennethnwc

from typing import Optional
from fastapi import FastAPI
from fastapi.middleware.cors import CORSMiddleware
import uvicorn
from tortoise import Tortoise, run_async
from tortoise.contrib.fastapi import register_tortoise
from tortoise.query_utils import Q
import pandas as pd

from models import Address_Pydantic, Address, Category_Pydantic, Category

kennethnwc

.next/
node_modules/
Dockerfile
yarn-error.log
.dockerignore
.git
.gitignore

kennethnwc

import Link from "next/link";
import Layout from "../components/Layout";
import { btn, btnPrimary } from "./_app.module.scss";

const IndexPage = () => (
  <Layout title="Home | Next.js + TypeScript Example">
    <h1>Hello Next.js 👋</h1>
    <p>
      <Link href="/about">
        <a>About</a>

kennethnwc

{
  "name": "with-typescript",
  "version": "1.0.0",
  "scripts": {
    "dev": "next",
    "build": "next build",
    "start": "next start",
    "type-check": "tsc",
    "scss": "tsm pages --aliasPrefixes.~ node_modules/"
  },

kennethnwc

import Link from "next/link";
import Layout from "../components/Layout";
import styles from "./_app.module.scss";

const IndexPage = () => (
  <Layout title="Home | Next.js + TypeScript Example">
    <h1>Hello Next.js 👋</h1>
    <p>
      <Link href="/about">
        <a>About</a>

kennethnwc

@import "~bootstrap/scss/_functions";
@import "~bootstrap/scss/_variables";
@import "~bootstrap/scss/_mixins";

@import "~bootstrap/scss/_root";
@import "~bootstrap/scss/_reboot";
@import "~bootstrap/scss/_type";
@import "~bootstrap/scss/_images";
@import "~bootstrap/scss/_code";
@import "~bootstrap/scss/_grid";

kennethnwc

import { AppProps } from "next/app";
import "./_app.module.scss";

export default ({ Component, pageProps }: AppProps) => {
  return <Component {...pageProps} />;
};