Files
clawfort/openspec/changes/p01-robust-onepager/proposal.md
2026-02-12 16:50:29 -05:00

2.1 KiB

Why

ClawFort needs a stunning one-page placeholder website that automatically generates and displays AI news hourly, creating a dynamic, always-fresh brand presence without manual content curation. The site will serve as a living showcase of AI capabilities while building brand recognition.

What Changes

  • New Capabilities:

    • Automated AI news aggregation via Perplexity API (hourly updates)
    • Dynamic hero section with featured news and images
    • Infinite scroll news feed with 1-month retention
    • Archive system for older news items
    • Containerized deployment (Docker)
    • Responsive single-page design with lean JavaScript framework
  • Frontend:

    • One-page website with hero block
    • Infinite scroll news feed (latest 10 on load)
    • News attribution to sources
    • Image credit display
    • Responsive design
  • Backend:

    • News aggregation service (hourly cron job)
    • Perplexity API integration
    • News storage with 30-day retention
    • Archive management
    • REST API for frontend
  • Infrastructure:

    • Docker containerization
    • Environment-based configuration
    • Perplexity API key management

Capabilities

New Capabilities

  • news-aggregator: Automated AI news collection via Perplexity API with hourly scheduling
  • news-storage: Database storage with 30-day retention and archive management
  • hero-display: Dynamic hero block with featured news and image attribution
  • infinite-scroll: Frontend infinite scroll with lazy loading (10 initial, paginated)
  • containerized-deployment: Docker-based deployment with environment configuration
  • responsive-frontend: Single-page application with lean JavaScript framework

Modified Capabilities

  • None (new project)

Impact

  • Code: New full-stack application (frontend + backend)
  • APIs: Perplexity API integration required
  • Dependencies: Docker, Node.js/Python runtime, database (SQLite/PostgreSQL)
  • Infrastructure: Container orchestration support
  • Environment: PERPLEXITY_API_KEY required
  • Data: 30-day rolling news archive with automatic cleanup