samkeen

Review Efficiency Prompt Template

Purpose: This template helps you engineer AI-generated artifacts that are optimized for efficient human review. Based on the principles from "Engineering AI Generated Artifacts for Human Review" (AlteredCraft).

The Core Insight: When AI generates artifacts, the marginal cost of including full context, rationale, and alternatives is minimal—but the review time saved is massive. This template embeds those requirements into your prompts.

Our Approach to Context

Advanced context tools exist (MCP servers, vector databases, ...), but this template takes a simpler path: leveraging AI coding agents' native ability to access file paths and URLs you provide.

samkeen

Of course. Here is the updated constitution with those three principles integrated.

---

Core Philosophy & Architecture 🏛️

• Follow SOLID Principles: Adhere strictly to the five SOLID principles (Single Responsibility, Open/Closed, Liskov Substitution, Interface Segregation, Dependency Inversion) to create a modular, scalable, and maintainable architecture.
• Explicit is Better than Implicit: Code should be clear and self-evident. Avoid clever tricks or "magic" that hide the underlying logic. The flow of data and control should be easy to follow.
• Simplicity and YAGNI: Prioritize simplicity and adhere to the "You Ain't Gonna Need It" principle. Do not add functionality or complexity until it is actively required.
• Manage State Predictably: Application state must be handled in a centralized and predictable manner. Avoid scattering state logic throughout the codebase. State changes should be explicit and traceable, minimizing side effects and making the application easier to debug.

samkeen

✻ Welcome to Claude Code!

/help for help, /status for your current setup

cwd: /Users/sam/Projects/code_coach

※ Tip: Press Shift+Enter to send a multi-line
message

> lets start the first lesson

samkeen

You are an expert code reviewer tasked with evaluating the fix you've just proposed for a coding issue. Your goal is to objectively assess your own solution, considering both its immediate effectiveness and its long-term implications for the codebase. Maintain a balanced perspective, neither blindly accepting nor rejecting the proposed fix.

You have already proposed an initial fix based on this context. Your task now is to critically evaluate this fix. Follow these steps:

1. Recall your proposed fix.
2. Analyze the fix from multiple perspectives: functionality, maintainability, scalability, and adherence to coding standards.
3. Consider the following aspects: a. Does it solve the immediate problem? b. Is it consistent with best coding practices? c. Does it integrate well with the existing codebase?

samkeen

[Project Name]

Every time you choose to apply a rule(s), explicitly state the rule(s) in the output. You can abbreviate the rule description to a single word or phrase.

Project Context

[Brief description ]

• [more description]
• [more description]
• [more description]

samkeen

# Supply a custom prompt to a LangChain QA Chain
system_template = """Use the following pieces of context to answer the question at the end. If you don't know the answer, just say that you don't know, don't try to make up an answer.

{context}

Question: {question}
Helpful Answer:"""
messages = [
    SystemMessagePromptTemplate.from_template(system_template),
    HumanMessagePromptTemplate.from_template("{question}"),

samkeen

import boto3

# This code deletes buckets on AWS S3.
# It is designed to be run on a local machine with credentials for an AWS account that has the
# necessary permissions to delete buckets.
# It will delete the contents of the buckets before deleting the bucket itself.
# It will not attempt to delete a bucket that does not exist.

# BUCKETS is a list of bucket names that should be deleted. If a bucket in the list does not
# exist, it will be skipped.

samkeen

"""
Usage example:

    from logger import get_logger
    log = get_logger()
    log.info('my_event', my_key1='val 1', my_key2=5, my_key3=[1, 2, 3], my_key4={'a': 1, 'b': 2})

List of metadata keys in each log message:
    event
    _func

samkeen

Ec2InPrivateSubnetWithouttNatGtwy:
    Type: AWS::EC2::Instance
    Properties:
      ImageId: !Ref LatestAmiId
      InstanceType: !Ref InstanceType
      # KeyName: NO SSH Key needed
      IamInstanceProfile: !Ref Ec2InstanceProfile
      NetworkInterfaces:
        # The SSM Agent running on the EC2 instances must be able to connect to Session Manager's
        # public endpoint. You can also set up a PrivateLink connection to allow instances running

samkeen

env:

  variables:
    LAMBDA_PKG_BUCKET_PREFIX: mia

phases:

  install:
    commands: