Monorepo Template Dev

Before creating any actual web sites, pages, or even components from my monorepo (d:\FSS\Websites\monorepo\), let’s first create a production grade Template site (d:\FSS\Websites\monorepo\sites\Template\) with all desired functionality and styling including documentation. Then it should be much easier to build the desired sites based on this established toolbox of components, blocks, pages, documentation, etc.

Template Dev plan

• Create Plan-Template-Dev.md

  • in D:\FSS\KB\Business\03_Processes\Website Dev\Template\Plan-Template-Dev.md
  • Yes, the first step in the plan is to create a high-quality spec-driven plan
  • Iterate with best thinking AI tools to refine project plan
  • Break plan into bite-sized tasks are easily and confidently implemented autonomously by AI tools
  • In markdown format, so the plan can evolve, and be easily referenced by the human manager and AI development tools
  • Model plan structure used by Github Spec Kit, if beneficial, as I might use this framework later.
  • If numbering the steps is beneficial (example 1.22), include this.
  • Steps to include
    • Fluid Design System, as specified in d:\FSS\KB\Business\03_Processes\Website Dev\FluidDesignSpec.md
    • Easy changing of Themes, including brand colors
    • Components, from Shadcn-Svelte
      • core components first (to be defined), then others
      • header, footer, hero, etc. (to be defined)
    • Blocks, combinations of components
    • Pages, combinations of blocks and components
    • logo (more info to come)
    • favicon, from logo
    • SMART DEBT JSX component, usable in .mdx
      • eg. provides CSS transition of ‘SMART DEBT Coach’ to ‘$MART DEBT Coach’ while maintaining SEO for ‘Smart Debt’, as done in d:\FSS\Websites\SDC.com\Mission\smartdebt-mission.html

• Create Rules for AI Dev

  • Clearly define all website dev guidelines for this project, for efficient spec-driven implementation by any AI dev agent, as better models are continually released
  • Iterate with best thinking AI tools to create all needed artifacts for world-class guidelines for effective AI development, with current web dev AI tools: Cursor, Warp
  • KB notes to reference, and upgrade as needed
    • d:\FSS\KB\Business\03_Processes\Website Dev\Monorepo Template Dev.md (this doc)
    • d:\FSS\KB\Business\03_Processes\Website Dev\Web Tech Stack.md
    • d:\FSS\KB\Business\03_Processes\Website Dev\FluidDesignSpec.md

Site Dev Workflow (draft)

• For the next Task in the master project plan, in Plan-Template-Dev.md, the AI agent …
  • reviews the Task and context carefully to confirm understanding, asking for more details if needed
  • implements the Task, with world-class, production-grade standards
  • thoroughly tests the Task against desired outcomes, and iterates up to 5 times, until successful, or reports if unsuccessful
  • notes any meaningful lessons that might be helpful in future steps of the development, in Lessons-Template-Dev.md
  • pushes a Git commit, describing the completed Task
  • marks the Task as complete, in the master project plan
  • other workflow steps??

My intention is to manually work through a few task development cycles to iron out the wrinkles in the workflow, and then hopefully deploy several agentic agents to work on tasks that can cleanly be executed in parallel autonomously. This should be realistic in the case of many web development tasks which should be independent of each other.

When the Template repo is complete, have the best AI tools thoroughly review it for any and all possible improvements, especially security, before declaring it production ready.

In the future, new components, blocks, or pages are first created, tested, and documented in the generic Template repo first, and then implemented in the desired site. This approach ensures a well-maintained Template with all site dev artifacts and documentation to build all other sites from.