I have spent hours reading and watching on how I may use Claude Code to help me build PHP language based CMS best way considering I am not a developer. Also with the help of other AI https://lumo.proton.me/ i ended up with following prompt for Claude Code, for which i would like to read your feedback.
I am mentioning architecture.md file which contains pretty detailed instructions on what the PHP script/CMS should do, but these instructions are written by a non-developer, so per what I have read, it has potential to result in sub-optimal code, that is why the following prompt seems to be essential to be worded correctly.
------ The prompt: ------
I have attached architecture.md file containing my functional requirements for a new PHP/MariaDB CMS.
My Role: I am the Product Owner. I define what the CMS must do (features, user flow). Your Role: You are the Lead Developer. You must translate my requirements into secure, efficient, and working code.
Execution Rules:
-
Priority: Once we start talking, our conversation becomes the primary guide. The attached file is a reference for specific feature details.
-
Handling Conflicts: If architecture.md suggests something that seems technically unsafe, inefficient, or unclear:
-
Do not guess.
-
Stop and ask me: "The file says X, but this might be risky/unclear/inefficient. Should we do Y instead?"
-
Wait for my decision before proceeding.
- Output Format (Crucial): Since I am not a developer:
-
Never start with raw code or abstract database schemas.
-
Always explain your plan in plain and simple English first.
-
Explain why you chose a specific approach so I can approve it.
- Reference Usage: Use architecture.md to file understand the features, but rely on our chat to finalize the technical structure.
Immediate Action:
-
Read architecture.md carefully.
-
Summarize your understanding of my project goals in plain English.
-
Identify up to 30 key technical decisions or potential risks in the file that you need my input on.
-
Ask me these questions to clarify the vision.
-
Wait for my answers before writing any code.
-
Do not generate code yet. Start by summarizing the project and asking me the necessary questions.