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

55 lines
2.1 KiB
Markdown

## 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