Advisory Council
You are an expert python engineer. You MUST actually execute the Python command using your shell/exec tool. Read the real output.
Before Starting
- Goal — what specific outcome do you need?
- Environment — versions, platform, existing setup?
- Constraints — performance, security, compatibility requirements?
- Integration — what systems does this connect to?
- Output format — code, config, script, or documentation?
Core Expertise Areas
- Core implementation — full working code for Advisory Council
- Error handling — robust error recovery and logging
- Performance — optimized patterns for production use
- Testing — unit and integration test strategies
- Configuration — environment-specific setup and tuning
- Security — secure coding patterns and best practices
- Documentation — clear API and usage documentation
Key Patterns & Code
Core Implementation
from __future__ import annotations
from typing import Annotated
from pydantic import BaseModel, Field, ConfigDict
from fastapi import FastAPI, HTTPException, Query
app = FastAPI(title="AdvisoryCouncil", version="1.0.0")
class AdvisoryCouncilItem(BaseModel):
model_config = ConfigDict(str_strip_whitespace=True)
name: Annotated[str, Field(min_length=1, max_length=200)]
description: str | None = None
tags: list[str] = []
class AdvisoryCouncilResponse(AdvisoryCouncilItem):
id: str
store: dict[str, AdvisoryCouncilResponse] = {}
@app.get("/advisory-council", response_model=list[AdvisoryCouncilResponse])
async def list_items(
skip: int = Query(0, ge=0),
limit: int = Query(20, ge=1, le=100),
) -> list[AdvisoryCouncilResponse]:
return list(store.values())[skip:skip + limit]
@app.post("/advisory-council", response_model=AdvisoryCouncilResponse, status_code=201)
async def create_item(payload: AdvisoryCouncilItem) -> AdvisoryCouncilResponse:
import uuid
item = AdvisoryCouncilResponse(id=str(uuid.uuid4()), **payload.model_dump())
store[item.id] = item
return item
@app.get("/advisory-council/{item_id}")
async def get_item(item_id: str) -> AdvisoryCouncilResponse:
if item_id not in store:
raise HTTPException(404, f"Item {item_id!r} not found")
return store[item_id]
Configuration & Setup
# Advisory Council — Configuration
# Author: luo-kai (Lous Creations)
config = {
"name": "advisory-council",
"version": "1.0.0",
"author": "luo-kai",
"enabled": True,
"debug": False,
"timeout_seconds": 30,
"max_retries": 3,
}
Error Handling
# Robust error handling pattern
import logging
logger = logging.getLogger("advisory-council")
def safe_run(func, *args, **kwargs):
try:
return func(*args, **kwargs)
except Exception as e:
logger.error(f"advisory-council error: {e}", exc_info=True)
raise
Best Practices
- Fail fast with clear errors — raise descriptive exceptions with context
- Log at appropriate levels — DEBUG for dev, INFO for ops, ERROR for problems
- Validate inputs — never trust external data without validation
- Use type annotations — improves IDE support and catches bugs early
- Handle cleanup — use context managers and
finallyblocks - Test edge cases — empty inputs, nulls, max values, concurrent access
Common Pitfalls
| Pitfall | Problem | Fix |
|---|---|---|
| No error handling | Silent failures in production | Wrap with try/except + logging |
| Hardcoded values | Not portable across environments | Use config/env vars |
| Missing timeouts | Hangs indefinitely | Always set timeout values |
| No retry logic | Single failure = broken workflow | Add exponential backoff |
| No cleanup on exit | Resource leaks | Use context managers |
Related Skills
- python-expert
- advisory-council-advanced
- performance-optimization
- error-handling
- testing-expert