Getting StartedBest Practices

ClackyAI Best Practices

ClackyAI empowers creators, teams, and non-technical users to build efficiently with AI. Follow these best practices to get the most out of the platform:

Task Splitting

While you can continuously work in the Root Thread, it’s recommended to break down each requirement into separate threads. This keeps contexts clear, aids collaboration, and makes tracking easier.

Clear Requirements

Each thread should handle only one clear, independent requirement of a manageable size (ideally, what would take 3–5 days for a developer). Avoid mixing unrelated or overly complex tasks in the same thread to help ClackyAI deliver higher quality results and make future tracking easier.

Plain Language

Anyone—product managers, designers, or developers—can describe their goals in plain and specific language. You don’t need to use technical terms; just be clear about your intent.

Good examples:

I need a page where users can upload and preview their avatar.

Please add an auto-rotating banner with three images on the homepage.

I suspect there's a configuration issue causing the search feature not to work. Please investigate and fix it.

Bug Reporting Tip: When describing a bug, include background, steps to reproduce, and any suspected cause to help AI resolve it faster.

Bad examples:

Add an avatar feature. (Too vague)

Search doesn't work, fix it. (No context or details)

Homepage is broken. (No specifics or expected result)

AI Creativity

You can provide a concise, one-sentence requirement and let ClackyAI explore possible solutions. Don’t over-constrain the details—leaving space for AI creativity can lead to innovative results.

Dependencies & Services

For complex dependencies or manual installations, it’s recommended to handle them yourself. ClackyAI has several built-in services (such as MySQL, Redis, MongoDB, Postgres) available for direct use. If you need to connect other third-party services, guide the AI step by step or provide additional context as needed.

Team Collaboration

ClackyAI supports both solo developers and team collaboration. Use features like threads and the “time machine” to improve teamwork and version control.

By following these practices, you’ll maximize ClackyAI’s potential across every stage of your project. Happy building!