Skip to content

Latest commit

 

History

History
98 lines (72 loc) · 6.35 KB

File metadata and controls

98 lines (72 loc) · 6.35 KB

Noderr Prompts Guide

Welcome to the command center for Noderr. This guide is your quick reference for all the prompts you'll use to orchestrate the AI agent.


The Core Development Loop

This verification-driven sequence is the heart of Noderr. You use these prompts in order for every new feature or significant fix. The process starts after you provide a PrimaryGoal in a work session.

Step Loop Prompt What It Does Your Action
1A noderr/prompts/NDv1.9__[LOOP_1A]__Propose_Change_Set.md Agent analyzes impact and proposes a "Change Set" of all affected nodes. Approve the scope.
1B noderr/prompts/NDv1.9__[LOOP_1B]__Draft_Specs.md Agent drafts all required specifications for the Change Set. Review the specs.
Gate noderr/prompts/NDv1.9__Spec_Verification_Checkpoint.md (Optional) A read-only check to verify spec completeness before coding. Run for large Change Sets.
2A noderr/prompts/NDv1.9__[LOOP_2A]__Implement_Change_Set.md Agent writes code for the Change Set and runs initial verification. Authorize implementation.
Gate noderr/prompts/NDv1.9__[LOOP_2B]__Verify_Implementation.md A mandatory read-only audit that compares code to specs and reports a completion %. Review audit & decide.
3 noderr/prompts/NDv1.9__[LOOP_3]__Finalize_And_Commit.md Agent updates docs to "as-built," logs work, and commits to the repository. Authorize finalization.

Note: The [LOOP_X] notation indicates the step number in the development cycle.


Workflow & Maintenance Prompts

These are the commands you'll use to manage the project's lifecycle.

Initial Setup

Prompt Purpose When to Use
noderr/prompts/NDv1.9__Strategic_Blueprint_Designer.md Create strategic foundation Before building, to establish rich context
noderr/prompts/NDv1.9__Install_And_Reconcile.md Install Noderr after initial build Once, after extracting ZIP
noderr/prompts/NDv1.9__Post_Installation_Audit.md Verify system integrity and complete architecture Immediately after Install_And_Reconcile

Daily Operations

Category Prompt When to Use
Setup noderr/prompts/NDv1.9__Install_And_Reconcile.md Once, after initial build and ZIP extraction
Session noderr/prompts/NDv1.9__Start_Work_Session.md At the beginning of every work session to sync the agent.
Session noderr/prompts/NDv1.9__Resume_Active_Loop.md If a work session was interrupted, to reconstruct context and resume.
Quality noderr/prompts/NDv1.9__Spec_Verification_Checkpoint.md Before Loop 2A, to verify specs for large (10+ node) Change Sets.
Quick Fix noderr/prompts/NDv1.9__Execute_Micro_Fix.md For tiny, localized fixes (< 50 lines) that don't require the full loop.
Bugs noderr/prompts/NDv1.9__Handle_Critical_Issue.md When something is broken. Guides a formal triage and diagnosis process.
Tech Debt noderr/prompts/NDv1.9__Refactor_Node.md To execute a REFACTOR_ task from the tracker and improve code quality.

Strategic Planning & Expansion Prompts

Use these high-level prompts to manage the project's long-term roadmap and health.

Category Prompt When to Use
Blueprint noderr/prompts/NDv1.9__Strategic_Blueprint_Designer.md To create rich strategic context before project setup
Ideation noderr/prompts/NDv1.9__Feature_Idea_Breakdown.md To turn a raw list of ideas into a prioritized, structured plan.
Planning noderr/prompts/NDv1.9__Pre_Flight_Feature_Analysis.md To perform a detailed analysis of a single feature before starting the loop.
Expansion noderr/prompts/NDv1.9__Major_Mid_Project_Feature_Addition.md To add a major new feature to a project that is already in progress.
Versioning noderr/prompts/NDv1.9__Expand_Completed_Project.md To plan the next version (e.g., v1.1) after the project reaches 100% completion.

Quality Assurance & Auditing Prompts

These prompts are for setting up and verifying projects, or for performing deep quality checks.

Category Prompt When to Use
Onboarding noderr/prompts/NDv1.9__Retrofit_Existing_Project.md To apply Noderr to a pre-existing codebase.
Validation noderr/prompts/NDv1.9__Onboarding_Audit_Verification.md To perform a quality check after a Retrofit operation.
Security noderr/prompts/NDv1.9__Advanced_Security_Audit.md To conduct a comprehensive security audit based on OWASP standards.
Quality noderr/prompts/NDv1.9__Architecture_Health_Review.md To conduct a periodic, deep audit of the entire project's health.
Deep Dive noderr/prompts/NDv1.9__Holistic_Integration_Audit.md To perform a detailed quality and integration check on a single completed feature.

Quick Decision Tree

  • Starting a new project?noderr/prompts/Strategic_Blueprint_Designer → Create project files → Build → Install
  • Just built initial prototype? → Extract ZIP → noderr/prompts/Install_And_Reconcile
  • Starting your work day?noderr/prompts/Start_Work_Session
  • Resuming interrupted work?noderr/prompts/NDv1.9__Resume_Active_Loop.md
  • Large Change Set (10+ NodeIDs)? → Run Spec_Verification_Checkpoint after Loop 1B.
  • Finished with Loop 2A? → Always run [LOOP_2B]__Verify_Implementation audit.
  • Have a new feature idea?noderr/prompts/Pre_Flight_Feature_Analysis → (then start the loop).
  • Found a small typo?noderr/prompts/Execute_Micro_Fix
  • Something is broken?noderr/prompts/Handle_Critical_Issue
  • Want to improve existing code?noderr/prompts/Refactor_Node
  • Time for a security check?noderr/prompts/Advanced_Security_Audit

Best Practices

  1. Always start with noderr/prompts/NDv1.9__Start_Work_Session.md - it syncs the AI with your project state
  2. The 4-step loop must be followed completely - don't skip steps, they ensure quality at each phase
  3. Use planning prompts before diving into code - they save time by thinking through complexity upfront
  4. Regular audits (Architecture Health, Security) prevent technical debt accumulation