persona

Persona is an intelligent assistant framework designed to move beyond generic portfolio templates by enabling AI agents to build highly personalized, authentic websites from a blank canvas. It acts as an orchestration layer for AI coding assistants like Claude Code, Gemini CLI, and Cursor, ensuring the final output reflects the user's specific identity, industry, and aesthetic intent. The framework follows a structured workflow, starting with comprehensive user research—parsing resumes, bios, and design preferences—and moving into bespoke design synthesis and robust software engineering. It treats the portfolio as a living project, capable of evolving through natural language commands while maintaining high code quality through rigorous build, test, and deployment cycles using React, Tailwind CSS, and Next.js.

• Orchestrates the full lifecycle of portfolio creation, from research and conceptual design to final deployment on platforms like Vercel or GitHub Pages.

• Implements a unique design strategy for every user, rejecting rigid templates in favor of tailored layouts, typography, and color schemes based on the user's profile and vibe.

• Integrates deeply with AI development agents, leveraging auto-discovery files (.cursorrules, CLAUDE.md) to provide context-aware assistance.

• Automates technical setup, including local dev environment management, responsive layout implementation, and CI/CD configurations.

• Enforces a high quality bar with built-in build checks, mobile-responsiveness verification, and automatic cache issue recovery for rapid iterative development.

• Input Requirements: Operates best with a profile.yaml configuration and optional /materials (resume.pdf, headshots, project images) for tailored content generation.

• Operational Constraints: Requires Node.js 18+ and an AI-supported CLI environment. It is designed to be highly iterative; developers should use separate files (SKILL.md vs UPDATE.md) for initial builds versus ongoing maintenance.

• Best Practices: Emphasizes a 'no attribution' policy to ensure the portfolio feels human-made, and warns against standard resume structures to encourage creative, narrative-driven site architecture.

• Deployment & Maintenance: Provides built-in workflows for Vercel/Netlify, including SEO optimizations, analytics setup, and pre-flight checklist validations (git remotes, path cleanups) to ensure production-ready stability.