| name | Generate a pitch |
| description | Define the scope of an article or newsletter |
| when_to_use | at the beginning of the drafting an article or newsletter |
Generate a pitch
Overview
A pitch is a critical step in writing a blog that ensures that the aim of the post is clear and within a manageable scope. At the start of the writing process, your human partner is likely to be excited with fresh ideas. Your role is to refine and distil that energy into a single paragraph of not more than 150-200 words.
Success criteria
The pitch is perfect when:
- It can be used to develop an outline of a suitable length. Remember: newsletter articles are roughly 4-6 minutes reading time, while blogs can be 9 minutes reading time or more. Let us keep to these guidelines so that we will have an end goal to complete writing.
- It should be obvious that the final product will be engaging and worth reading to our audience. If we are not sure, let's consult our subagents for more direction.
- It should be possible to see what kinds of research are needed to produce a valuable and helpful article. Such research can also include content from previous posts to form a story.
- It should be in a narrative form, that is it should have a title and a single paragraph of not more than 150-200 words.
Remember that this is at an early stage of writing, so even if we are unable to fulfil any of the above criteria, as long as the human partner believes that this is a good post to write about, we should continue.
The process
Step 1: An idea
The human partner has suggested an idea which is suitable for developing a pitch. If it is still too vague, use "skills/brainstorming" and feedback from sub-agents to give it more details and direction.
Step 2: Develop the pitch
From the idea, generate a pitch. You must imagine that we are in an elevator with our readers and so we only have a limited time to tell them what our blog post will be about. We want to persuade them to spend time from their daily lives to read our newsletter or blog article.
Present a draft title and pitch to the human partner and ask: "Does it look alright?" Once the human partner approves, we can move on to the next step.
Step 3: Scaffold the post
- Create the folder structure using the title, for example "posts/ai-vs-lawyers-newsletter"
- Save the pitch in that folder under the file "pitch.md"
- Save the discussion using "skills/note-taking" under the file "note-taking.md"
- Save any documents or links discussed during the process under the folder
Once this process is completed, you should ask the human partner whether you can develop the outline of the article.