From 6a435e8c1296c597a632bba64d6491306d07a933 Mon Sep 17 00:00:00 2001 From: Jeremy Eder Date: Tue, 24 Feb 2026 17:50:18 -0500 Subject: [PATCH] chore: remove root-level cruft and clean up .gitignore Delete 34 tracked files (27,392 lines) of accumulated development artifacts: .cursor/commands/, .specify/, Prompts/, hack/, repomix-analysis/, AMBER_SETUP.md, TESTING_SUMMARY.md, and an empty root package-lock.json. Rewrite .gitignore from scratch as project-specific rules, removing 18 irrelevant framework sections (Django, Flask, Scrapy, Jupyter, etc.) cargo-culted from a generic Python template. Add patterns to prevent re-introduction of removed artifacts. Fix trailing whitespace and missing final newlines in 10 files across frontend, manifests, runner, and docs (auto-fixed by pre-commit hooks). Co-Authored-By: Claude Opus 4.6 (1M context) --- .cursor/commands/analyze.md | 101 - .cursor/commands/clarify.md | 158 - .cursor/commands/constitution.md | 73 - .cursor/commands/implement.md | 56 - .cursor/commands/plan.md | 43 - .cursor/commands/specify.md | 21 - .cursor/commands/tasks.md | 62 - .gitignore | 162 +- .specify/memory/constitution.md | 417 - .../memory/constitution_update_checklist.md | 85 - .specify/memory/orginal/architecture.md | 853 - .specify/memory/orginal/capabilities.md | 123 - .specify/scripts/bash/check-prerequisites.sh | 166 - .../scripts/bash/check-task-prerequisites.sh | 15 - .specify/scripts/bash/common.sh | 156 - .specify/scripts/bash/create-new-feature.sh | 260 - .specify/scripts/bash/get-feature-paths.sh | 7 - .specify/scripts/bash/setup-plan.sh | 61 - .specify/scripts/bash/update-agent-context.sh | 772 - .specify/templates/agent-file-template.md | 28 - .specify/templates/checklist-template.md | 40 - .specify/templates/plan-template.md | 104 - .specify/templates/spec-template.md | 115 - .specify/templates/tasks-template.md | 251 - AMBER_SETUP.md | 513 - Prompts/bug-assessment.prompt.yml | 11 - Prompts/feature-assessment.prompt.yml | 10 - Prompts/general-assessment.prompt.yml | 11 - TESTING_SUMMARY.md | 396 - .../[name]/sessions/[sessionName]/page.tsx | 136 +- .../workspace-sections/settings-section.tsx | 3 +- .../manifests/base/backend-deployment.yaml | 3 +- .../manifests/base/frontend-deployment.yaml | 1 - components/manifests/base/kustomization.yaml | 1 - .../manifests/overlays/e2e/kustomization.yaml | 1 - .../overlays/kind/kustomization.yaml | 1 - .../runners/claude-code-runner/Dockerfile | 2 +- components/runners/state-sync/hydrate.sh | 27 +- hack/automated-deployer.yaml | 127 - mkdocs.yml | 2 +- package-lock.json | 6 - repomix-analysis/03-architecture-only.xml | 21767 ---------------- repomix-analysis/repomix-analysis-report.md | 583 - repomix-analysis/repomix-heatmap.png | Bin 297944 -> 0 bytes 44 files changed, 150 insertions(+), 27580 deletions(-) delete mode 100644 .cursor/commands/analyze.md delete mode 100644 .cursor/commands/clarify.md delete mode 100644 .cursor/commands/constitution.md delete mode 100644 .cursor/commands/implement.md delete mode 100644 .cursor/commands/plan.md delete mode 100644 .cursor/commands/specify.md delete mode 100644 .cursor/commands/tasks.md delete mode 100644 .specify/memory/constitution.md delete mode 100644 .specify/memory/constitution_update_checklist.md delete mode 100644 .specify/memory/orginal/architecture.md delete mode 100644 .specify/memory/orginal/capabilities.md delete mode 100755 .specify/scripts/bash/check-prerequisites.sh delete mode 100755 .specify/scripts/bash/check-task-prerequisites.sh delete mode 100755 .specify/scripts/bash/common.sh delete mode 100755 .specify/scripts/bash/create-new-feature.sh delete mode 100755 .specify/scripts/bash/get-feature-paths.sh delete mode 100755 .specify/scripts/bash/setup-plan.sh delete mode 100755 .specify/scripts/bash/update-agent-context.sh delete mode 100644 .specify/templates/agent-file-template.md delete mode 100644 .specify/templates/checklist-template.md delete mode 100644 .specify/templates/plan-template.md delete mode 100644 .specify/templates/spec-template.md delete mode 100644 .specify/templates/tasks-template.md delete mode 100644 AMBER_SETUP.md delete mode 100644 Prompts/bug-assessment.prompt.yml delete mode 100644 Prompts/feature-assessment.prompt.yml delete mode 100644 Prompts/general-assessment.prompt.yml delete mode 100644 TESTING_SUMMARY.md delete mode 100644 hack/automated-deployer.yaml delete mode 100644 package-lock.json delete mode 100644 repomix-analysis/03-architecture-only.xml delete mode 100644 repomix-analysis/repomix-analysis-report.md delete mode 100644 repomix-analysis/repomix-heatmap.png diff --git a/.cursor/commands/analyze.md b/.cursor/commands/analyze.md deleted file mode 100644 index f4c1a7bd9..000000000 --- a/.cursor/commands/analyze.md +++ /dev/null @@ -1,101 +0,0 @@ ---- -description: Perform a non-destructive cross-artifact consistency and quality analysis across spec.md, plan.md, and tasks.md after task generation. ---- - -The user input to you can be provided directly by the agent or as a command argument - you **MUST** consider it before proceeding with the prompt (if not empty). - -User input: - -$ARGUMENTS - -Goal: Identify inconsistencies, duplications, ambiguities, and underspecified items across the three core artifacts (`spec.md`, `plan.md`, `tasks.md`) before implementation. This command MUST run only after `/tasks` has successfully produced a complete `tasks.md`. - -STRICTLY READ-ONLY: Do **not** modify any files. Output a structured analysis report. Offer an optional remediation plan (user must explicitly approve before any follow-up editing commands would be invoked manually). - -Constitution Authority: The project constitution (`.specify/memory/constitution.md`) is **non-negotiable** within this analysis scope. Constitution conflicts are automatically CRITICAL and require adjustment of the spec, plan, or tasks—not dilution, reinterpretation, or silent ignoring of the principle. If a principle itself needs to change, that must occur in a separate, explicit constitution update outside `/analyze`. - -Execution steps: - -1. Run `.specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks` once from repo root and parse JSON for FEATURE_DIR and AVAILABLE_DOCS. Derive absolute paths: - - SPEC = FEATURE_DIR/spec.md - - PLAN = FEATURE_DIR/plan.md - - TASKS = FEATURE_DIR/tasks.md - Abort with an error message if any required file is missing (instruct the user to run missing prerequisite command). - -2. Load artifacts: - - Parse spec.md sections: Overview/Context, Functional Requirements, Non-Functional Requirements, User Stories, Edge Cases (if present). - - Parse plan.md: Architecture/stack choices, Data Model references, Phases, Technical constraints. - - Parse tasks.md: Task IDs, descriptions, phase grouping, parallel markers [P], referenced file paths. - - Load constitution `.specify/memory/constitution.md` for principle validation. - -3. Build internal semantic models: - - Requirements inventory: Each functional + non-functional requirement with a stable key (derive slug based on imperative phrase; e.g., "User can upload file" -> `user-can-upload-file`). - - User story/action inventory. - - Task coverage mapping: Map each task to one or more requirements or stories (inference by keyword / explicit reference patterns like IDs or key phrases). - - Constitution rule set: Extract principle names and any MUST/SHOULD normative statements. - -4. Detection passes: - A. Duplication detection: - - Identify near-duplicate requirements. Mark lower-quality phrasing for consolidation. - B. Ambiguity detection: - - Flag vague adjectives (fast, scalable, secure, intuitive, robust) lacking measurable criteria. - - Flag unresolved placeholders (TODO, TKTK, ???, , etc.). - C. Underspecification: - - Requirements with verbs but missing object or measurable outcome. - - User stories missing acceptance criteria alignment. - - Tasks referencing files or components not defined in spec/plan. - D. Constitution alignment: - - Any requirement or plan element conflicting with a MUST principle. - - Missing mandated sections or quality gates from constitution. - E. Coverage gaps: - - Requirements with zero associated tasks. - - Tasks with no mapped requirement/story. - - Non-functional requirements not reflected in tasks (e.g., performance, security). - F. Inconsistency: - - Terminology drift (same concept named differently across files). - - Data entities referenced in plan but absent in spec (or vice versa). - - Task ordering contradictions (e.g., integration tasks before foundational setup tasks without dependency note). - - Conflicting requirements (e.g., one requires to use Next.js while other says to use Vue as the framework). - -5. Severity assignment heuristic: - - CRITICAL: Violates constitution MUST, missing core spec artifact, or requirement with zero coverage that blocks baseline functionality. - - HIGH: Duplicate or conflicting requirement, ambiguous security/performance attribute, untestable acceptance criterion. - - MEDIUM: Terminology drift, missing non-functional task coverage, underspecified edge case. - - LOW: Style/wording improvements, minor redundancy not affecting execution order. - -6. Produce a Markdown report (no file writes) with sections: - - ### Specification Analysis Report - | ID | Category | Severity | Location(s) | Summary | Recommendation | - |----|----------|----------|-------------|---------|----------------| - | A1 | Duplication | HIGH | spec.md:L120-134 | Two similar requirements ... | Merge phrasing; keep clearer version | - (Add one row per finding; generate stable IDs prefixed by category initial.) - - Additional subsections: - - Coverage Summary Table: - | Requirement Key | Has Task? | Task IDs | Notes | - - Constitution Alignment Issues (if any) - - Unmapped Tasks (if any) - - Metrics: - * Total Requirements - * Total Tasks - * Coverage % (requirements with >=1 task) - * Ambiguity Count - * Duplication Count - * Critical Issues Count - -7. At end of report, output a concise Next Actions block: - - If CRITICAL issues exist: Recommend resolving before `/implement`. - - If only LOW/MEDIUM: User may proceed, but provide improvement suggestions. - - Provide explicit command suggestions: e.g., "Run /specify with refinement", "Run /plan to adjust architecture", "Manually edit tasks.md to add coverage for 'performance-metrics'". - -8. Ask the user: "Would you like me to suggest concrete remediation edits for the top N issues?" (Do NOT apply them automatically.) - -Behavior rules: -- NEVER modify files. -- NEVER hallucinate missing sections—if absent, report them. -- KEEP findings deterministic: if rerun without changes, produce consistent IDs and counts. -- LIMIT total findings in the main table to 50; aggregate remainder in a summarized overflow note. -- If zero issues found, emit a success report with coverage statistics and proceed recommendation. - -Context: $ARGUMENTS diff --git a/.cursor/commands/clarify.md b/.cursor/commands/clarify.md deleted file mode 100644 index 26ff530bd..000000000 --- a/.cursor/commands/clarify.md +++ /dev/null @@ -1,158 +0,0 @@ ---- -description: Identify underspecified areas in the current feature spec by asking up to 5 highly targeted clarification questions and encoding answers back into the spec. ---- - -The user input to you can be provided directly by the agent or as a command argument - you **MUST** consider it before proceeding with the prompt (if not empty). - -User input: - -$ARGUMENTS - -Goal: Detect and reduce ambiguity or missing decision points in the active feature specification and record the clarifications directly in the spec file. - -Note: This clarification workflow is expected to run (and be completed) BEFORE invoking `/plan`. If the user explicitly states they are skipping clarification (e.g., exploratory spike), you may proceed, but must warn that downstream rework risk increases. - -Execution steps: - -1. Run `.specify/scripts/bash/check-prerequisites.sh --json --paths-only` from repo root **once** (combined `--json --paths-only` mode / `-Json -PathsOnly`). Parse minimal JSON payload fields: - - `FEATURE_DIR` - - `FEATURE_SPEC` - - (Optionally capture `IMPL_PLAN`, `TASKS` for future chained flows.) - - If JSON parsing fails, abort and instruct user to re-run `/specify` or verify feature branch environment. - -2. Load the current spec file. Perform a structured ambiguity & coverage scan using this taxonomy. For each category, mark status: Clear / Partial / Missing. Produce an internal coverage map used for prioritization (do not output raw map unless no questions will be asked). - - Functional Scope & Behavior: - - Core user goals & success criteria - - Explicit out-of-scope declarations - - User roles / personas differentiation - - Domain & Data Model: - - Entities, attributes, relationships - - Identity & uniqueness rules - - Lifecycle/state transitions - - Data volume / scale assumptions - - Interaction & UX Flow: - - Critical user journeys / sequences - - Error/empty/loading states - - Accessibility or localization notes - - Non-Functional Quality Attributes: - - Performance (latency, throughput targets) - - Scalability (horizontal/vertical, limits) - - Reliability & availability (uptime, recovery expectations) - - Observability (logging, metrics, tracing signals) - - Security & privacy (authN/Z, data protection, threat assumptions) - - Compliance / regulatory constraints (if any) - - Integration & External Dependencies: - - External services/APIs and failure modes - - Data import/export formats - - Protocol/versioning assumptions - - Edge Cases & Failure Handling: - - Negative scenarios - - Rate limiting / throttling - - Conflict resolution (e.g., concurrent edits) - - Constraints & Tradeoffs: - - Technical constraints (language, storage, hosting) - - Explicit tradeoffs or rejected alternatives - - Terminology & Consistency: - - Canonical glossary terms - - Avoided synonyms / deprecated terms - - Completion Signals: - - Acceptance criteria testability - - Measurable Definition of Done style indicators - - Misc / Placeholders: - - TODO markers / unresolved decisions - - Ambiguous adjectives ("robust", "intuitive") lacking quantification - - For each category with Partial or Missing status, add a candidate question opportunity unless: - - Clarification would not materially change implementation or validation strategy - - Information is better deferred to planning phase (note internally) - -3. Generate (internally) a prioritized queue of candidate clarification questions (maximum 5). Do NOT output them all at once. Apply these constraints: - - Maximum of 5 total questions across the whole session. - - Each question must be answerable with EITHER: - * A short multiple‑choice selection (2–5 distinct, mutually exclusive options), OR - * A one-word / short‑phrase answer (explicitly constrain: "Answer in <=5 words"). - - Only include questions whose answers materially impact architecture, data modeling, task decomposition, test design, UX behavior, operational readiness, or compliance validation. - - Ensure category coverage balance: attempt to cover the highest impact unresolved categories first; avoid asking two low-impact questions when a single high-impact area (e.g., security posture) is unresolved. - - Exclude questions already answered, trivial stylistic preferences, or plan-level execution details (unless blocking correctness). - - Favor clarifications that reduce downstream rework risk or prevent misaligned acceptance tests. - - If more than 5 categories remain unresolved, select the top 5 by (Impact * Uncertainty) heuristic. - -4. Sequential questioning loop (interactive): - - Present EXACTLY ONE question at a time. - - For multiple‑choice questions render options as a Markdown table: - - | Option | Description | - |--------|-------------| - | A |